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PREFACE 


The  TABS-2  system  described  herein  was  developed  over  the 
period  1972-1984.  This  User's  Manual  was  prepared  at  the  US  Army 
Engineer  Waterways  Experiment  Station  (WES)  with  funding  provided 
by  the  Office,  Chief  of  Engineers,  US  Army,  under  the  Improvement 
of  Operations  and  Maintenance  Techniques  (IOMT)  research  program. 
Funding  for  the  various  components  of  the  system  came  from 
several  sources  within  the  Corps  of  Engineers,  but  the  largest 
portion  of  those  funds  came  from  the  10MT  Program.  Technical 
monitors  of  the  IOMT  program  were  Messrs.  J.  L.  Gottesman  and 
C.  W.  Hummer,  Jr. 

The  principal  sources  for  the  programs  and  procedures  are 
the  staff  of  the  WES  Hydraulics  Laboratory;  Resource  Management 
A  sociates,  Lafayette,  Calif.;  University  of  California,  Davis; 

US  Army  Corps  of  Engineers  Hydrologic  Engineering  Center;  and  the 
WES  Environmental  Laboratory.  Sources  of  individual  programs  in 
the  TABS  —  2  system  are  given  in  this  manual  where  the  programs  are 
described  . 

Personnel  of  the  WES  Hydraulics  Laboratory  performed  their 
portion  of  system  development  under  direction  of  Messrs.  H.  B. 
Simmons  and  F.  A.  Herrmann,  Jr.,  former  and  present  Chiefs  of  the 
Hydraulics  Laboratory,  respectively;  M.  B.  Boyd,  Chief  of  the 
Hydraulic  Analysis  Division;  R.  A.  Sager,  Chief  of  the  Estuaries 
Division;  G.  M.  Fisackerly,  Chief  of  the  Harbor  Entrance  Branch; 
R.  A.  Boland,  Chief  of  the  Hydrodynamics  Branch;  and  E.  C. 

McNair,  Chief  of  the  Sedimentation  Branch.  Messrs.  W.  A.  Thomas 
and  W.  H.  McAnally  supervised  development  of  the  programs  and 
system  and  prepared  this  report.  Authors  of  the  appendices,  pub¬ 
lished  separately  in  looseleaf  form,  are  cited  in  each  appendix. 

Hydraulics  Laboratory  personnel  making  major  contributions 
to  development  of  the  TABS-2  system  were  S.  A.  Adamec,  R.  F. 
Athow,  D.  P.  Bach,  R.  C.  Berger,  B.  Brown,  Jr.,  C.  J.  Coleman, 
R.  R.  Copeland,  B.  Park-Donnell,  J.  D.  Ethridge,  Jr.,  M.  A. 
Granat,  S.  S.  Grogan,  R.  E.  Heath,  S.  B.  Heltzel,  J.  V.  Letter, 
Jr.,  R.  D.  Schneider,  T.  M.  Smith,  D.  M.  Stewart,  J.  P. 

Stewart,  A.  M.  Teeter,  and  M.  J.  Trawle.  Dr.  V.  E.  La  Garde, 

WES  Environmental  Laboratory,  performed  initial  development  of 
many  DMS-A  programs.  Messrs.  A.  Melidor,  St.  Louis  District,  and 
J.  Hines,  Vicksburg  District,  performed  field  trials  of  many  of 
the  programs.  Mr.  Hines  initiated  development  of  the  Greenville 
Reach  mesh. 

Commanders  and  Directors  of  WES  during  the  preparation  of 
this  manual  were  COL  Nelson  P.  Conover,  CE,  COL  Tilford  C.  Creel, 
CE,  and  COI.  Robert  C.  Lee,  CE;  Technical  Director  was  Mr.  F.  R. 
Brown.  Commander  at  time  of  publication  was  COL  Allen  F.  Grum, 
USA,  and  Technical  Director  was  Dr.  Robert  W.  Whalin. 
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Non-SI  units  of  measurement  used  in  this  report  can  be 
converted  to  SI  (metric)  units  as  follows: 


_ Multiply _ 

cubic  feet  per  second 
feet 

feet  per  second 
inches 


By 

0.02831685 

0.3048 

0.3048 

25.4 


_ To  Obtain _ 

cubic  metres  per  second 
metres 

metres  per  second 
millimetres 
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USER'S  MANUAL  FOR  THE  GENERALIZED 
COMPUTER  PROGRAM  SYSTEM 

OPEN-CHANNEL  FLOW  AND  SEDIMENTATION 
TABS-2 
Main  Text 

PART  I:  INTRODUCTION 
Purpose 

1.  This  report  describes  use  of  the  TABS-2  system  for 
numerical  modeling.  The  purpose  of  the  TABS-2  system  is  to 
provide  a  complete  set  of  generalized  computer  programs  for  two- 
dimensional  (2  —  D )  numerical  modeling  of  open-channel  flow,  trans¬ 
port  processes,  and  sedimentation.  These  processes  are  modeled 
to  help  solve  hydraulic  engineering  and  environmental  problems  in 
waterways.  The  system  is  designed  to  be  used  by  engineers  and 
scientists  who  need  not  be  computer  experts. 

Description 

2.  TABS-2  is  a  collection  of  generalized  computer  programs 
and  utility  codes  integrated  into  a  numerical  modeling  system  for 
studying  2-D  hydraulics,  transport,  and  sedimentation  problems  in 
rivers,  reservoirs,  bays,  and  estuaries.  A  schematic  representa¬ 
tion  of  the  system  is  shown  in  Figure  1. 


TA6S-2 


Figure  1.  TABS-2  schematic 

It  can  be  used  either  as  a  stand-alone  solution  technique  or  as  a 
step  in  the  hybrid  modeling  approach.  The  basic  concept  is  to 
calculate  water-surface  elevations,  current  patterns,  dispersive 
transport,  sediment  erosion,  transport  and  deposition,  resulting 
bed-surface  elevations,  and  feedback  to  hydraulics.  Existing  and 
proposed  geometry  can  be  analyzed  to  determine  the  impact  of 
project  designs  on  flows,  sedimentation,  and  salinity.  The  cal¬ 
culated  velocity  pattern  around  structures  and  islands  is  espe¬ 
cially  useful. 
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3.  The  three  baste  components  of  the  system  are: 

a.  "Two-Dimensional  Model  for  Open-Channel  Flows," 
RMA-2V. 

b.  "Sediment  Transport  in  Unsteady  Two-Dimensional 
Flows,  Horizontal  Plane,”  STUDH. 

c_.  "Two-Dimensional  Model  for  Water  Quality,"  RMA-4. 

4.  RMA-2V  is  a  finite  element  solution  of  the  Reynolds  form 
of  the  Navier-Stokes  equations  for  turbulent  flows.  Friction  is 
calculated  with  Manning's  equation  and  eddy  viscosity  coeffi¬ 
cients  are  used  to  define  turbulence  characteristics.  A  velocity 
form  of  the  basic  equation  is  used  with  side  boundaries  treated 
as  either  slip  (parallel  flow)  or  static  (zero  flow).  The  model 
automatically  recognizes  dry  elements  and  corrects  the  mesh 
accordingly.  Boundary  conditions  may  be  water-surface  eleva¬ 
tions,  velocities,  or  discharges  and  may  occur  inside  the  mesh  as 
well  as  along  the  edges. 

5.  The  sedimentation  model,  STUDH,  solves  the  convection- 
diffusion  equation  with  bed  source  terms.  These  terms  are  struc¬ 
tured  for  either  sand  or  cohesive  sediments.  The  Ackers-White 
procedure  is  used  to  calculate  a  sediment  transport  potential  for 
the  sands  from  which  the  actual  transport  is  calculated  based  on 
availability.  Clay  erosion  is  based  on  work  by  Partheniades  and 
the  deposition  of  clay  utilizes  Krone’s  equations.  Deposited 
material  forms  layers,  as  shown  in  Figure  2,  and  bookkeeping 
within  the  STUDH  code  allows  up  to  10  layers  at  each  node  for 
maintaining  separate  material  types,  deposit  thickness,  and  age. 
The  code  uses  the  same  mesh  as  RMA-2V. 


Figure  2.  Bed  layering  in  STUDH 
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6.  Transport  calculations  with  RMA-4  arc  made  usint;  a  form 
of  the  convection -diffusion  equation  that  has  general  source-sink 
terms.  Up  to  seven  conservative  substances  or  substances 
requiring  a  decay  term  can  be  routed.  The  code  uses  the  same 
mesh  as  RMA-2V. 


7.  Each  of  these  generalized  computer  codes  (RMA-2V,  STUDH, 
and  RMA-4)  can  be  used  as  a  stand-alone  program.  To  facilitate 
the  preparation  of  input  data  and  to  aid  in  analyzing  results,  a 
family  of  utility  programs  was  developed  for  the  following  tasks: 

£.  DIGITIZING 

b.  MESH  GENERATION 


'm 

> 

fe: 

V.- . 

& 

m 

i 


C- .  SPATIAL  DATA  MANAGEMENT 

d.  GRAPHICAL  OUTPUT 

e.  OUTPUT  ANALYSIS 
_t_.  PILE  MANAGEMENT 
g.  INTERFACES 

h_.  AUTOMATIC  JOB  CONTROL  LANGUAGE 

The  codes  for  accomplishing  these  tasks  are  shown  in  PART  V  of 
this  manual. 

B.  One  can  assume  the  nature  of  the  computations  by  their 
state  ii  purpose;  but  to  better  illustrate  the  roll  these  utility 
codes  play  in  TABS- 2,  an  analogy  between  the  steps  in  a  physical 
modeling  study  and  a  numerical  modeling  study  o  t  the  same  problem 
is  useful. 

9.  Both  fixed-  and  mobile -bound  ary  hydraulic  problems  are 
classified  as  'boundary  value"  problems.  The  project  area  has  to 
be  defined  and  a  boundary  drawn  completely  around  it.  The  space 
within  the  boundary  becomes  the  study  area  and  hydraulic 
processes  in  the  area  depend  on  what  occurs  at  the  boundaries. 

In  a  physical  model  study,  the  geometry  of  that  space  is  molded 
to  create  a  scale  model  of  the  prototype.  In  a  numerical  model 
study,  h  y  d  r o  g raphic  maps  are  DIGITIZED  into  (  x  ,  y  ,  z ) - c  o  o  r  d i nates 
to  create  a  digital  map  of  that  space.  Next,  in  a  physical  model 
study,  the  model  is  flooded,  the  tailwater  elevation  is  set  at 
the  downstream  boundary,  the  flow  is  set  at  the  upstream 
boundary,  and  the  interior  of  the  model  automatically  responds  to 
those  B  0  U  N  D  A  R  Y  CO  N  D  1  T  I  (1  N  S  .  In  a  numerical  model,  the  concept  is 
the  same,  but  the  procedure  tor  executing  the  numerical  model  is 
somewhat  more  abstract.  First,  the  digital  map  will  have  more 
data  points  than  can  be  used  in  today's  computers,  so  points  are 
consolidated  into  computation  nodes.  These  nodes  are  then  linked 
together,  using  quadrilateral  or  Irian g u  l  a  r  shapes,  into  a  compu¬ 
tation  space.  These  shapes,  called  elements,  form  a  mesh  and  the 


A  B ' 
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process  of  developing  the  mesh  is  called  MESH  GENERATION.  The 
step  similar  to  flooding  the  physical  mode  1 ,  called  INITIAL 
CONDITIONS  in  the  numerical  model  study,  requires  that  an  initial 
depth  of  water  be  prescribed  at  each  node  in  the  mesh.  The 
tailwater  and  headwater  conditions  are  prescribed  (i.e.,  the 
BOUNDARY  CONDITIONS)  and  the  model  is  run,  at  which  time  the 
computer  solves  the  basic  equations  at  each  node  and  produces  the 
internal  response  to  the  BOUNDARY  CONDITIONS.  For  this  reason, 
it  is  called  a  boundary  value  problem. 

10.  Whereas  the  response  of  the  physical  model  can  be 
easily  viewed,  the  response  of  the  numerical  model  is  simply 
spatial  data  sets  of  numbers.  They  are  called  spatial  because 
the  computer  program  produces  a  set  of  numbers  at  each  node 
within  the  model  boundary  (i.e.,  over  the  model  space)  and  a 
typical  mesh  will  have  several  thousand  nodes.  The  analysis  of 
numerical  model  behavior  requires  the  evaluation  of  these  numbers 
as  well  as  their  gradients  in  the  (x,y)  plane.  (For  example,  a 
water-surface  profile  becomes  a  water-surlace  plane  because  there 
is  a  calculated  water-surface  elevation  at  each  node.)  The 
handling,  storing,  and  comparing  of  large  sets  of  spatial  data 
are  extremely  important  parts  of  the  TABS -2  system,  as  shown 

by  references  to  SPATIAL  DATA  MANAGEMENT,  GRAPHICAL  OUTPUT,  and 
OUTPUT  ANALYSIS  utilities.  Their  purpose  is  to  aid  in  analyzing 
and  displaying  results  of  the  numerical  model  study. 

11.  Each  time  a  new  set  of  boundary  conditions  is  pre¬ 
scribed  or  a  new  design  change  in  geometry  is  proposed,  another 
spatial  data  set  is  produced.  The  task  of  storing,  retrieving, 
and  using  these  data  sets  requires  careful  indexing  and  labeling. 
A  F  t  LE  MANAGE  R  was  developed  to  handle  that  task. 

12.  Occasionally,  spatial  data  sets  must  be  manipulated 
before  being  used  by  another  program.  Special  INTERFACE  utili¬ 
ties  were  prepared  for  those  occasions. 

11.  Finally,  an  AUTOMATIC  JOB  CONTROL  LANGUAGE  (JCL)  proce¬ 
dure  tile  was  developed  for  executing  the  TABS- 2  programs.  It 
allows  input  and  output  tile  names  to  he  assigned  at  execution 
time  and  keeps  the  details  of  the  JCL  transparent  to  the  user, 
this  procedure  file,  called  P  ROCL V ,  is  complete  with  a  "HELP" 
command  that  describes  the  input  data. 


Scope 


14.  This  user's  manual  provides  instructions  (or  coding 
data  tor  the  TABS -2  system.  Sufficient  theory  is  provided  to 
guide  in  the  selection  of  coefficients  and  in  decisions  regarding 
applicability.  A  major  factor  in  this  class  of  computer  programs 
is  problem  size,  and  this  manual  shows  h o  w  to  change  array  dimen¬ 
sions  as  needed  to  fit  t  h  e  programs  to  the  size  o  t  p  r  o  b  1  e  m  s  be  i  n  g 
analyzed.  Although  modeling  is  very  much  an  art,  some  general 
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procedures  are  useful  in  every  study 
this  manual. 


These  are  presented  in 


15.  This  document  does  not  show  the  complete  theoretical 
development  of  the  computer  programs.  References  are  made  to 
other  reports  where  details  are  presented.  The  development  of 
"representative  data"  is  generally  beyond  the  scope  of  this 
document,  and  yet  that  is  the  key  to  most  successful  modeling 
studies.  The  criteria  to  use  in  assessing  numerical  model  per¬ 
formance  depend  upon  the  specific  model  and  the  questions  being 
asked  of  it.  Only  limited  material  is  presented  in  this  document 
for  assessing  model  performance  criteria.  The  absence  of  diagnos¬ 
tics  and  error  messages  does  not  guarantee  satisfactory  model 
performance . 


A  Comparison  of  1-D  and  2-D  Numerical  Modeling 


16.  The  one-dimensional  (1-D)  backwater  calculation  is  a 
familiar  numerical  model  in  which  river  cross  sections  are  de¬ 
scribed,  a  tailwater  elevation  is  established,  a  water  discharge 
is  established,  and  the  resulting  water-surface  profile  is  calcu¬ 
lated  by  solving  the  1-D  form  of  the  energy  equation.  In  that 
calculation,  the  geometry  is  described  by  cross  section  and  reach 
lengths  (i.e.,  the  distance  between  cross  sections).  The  align¬ 
ment  of  each  cross  section  should  make  it  perpendicular  to  the 
approaching  flow.  Although  the  location  of  the  cross  section  is 
frequently  shown  on  the  study  area  map,  that  section  should  be 
replaced  by  a  single  computation  node  to  depict  the  reality  of 
the  1-D  solution.  Although  the  cross  sections  can  be  irregular 
in  shape,  the  resulting  calculated  velocity  is  but  an  average. 


17.  The  2-D  model  on  the  other  hand,  does  not  work  directly 
from  cross  sections.  However,  there  is  still  a  requirement  for 
geometry.  This  is  satisfied  by  the  finite  element  (  F  E  )  mesh. 

One  significant  difference  is  that  the  computation  points  (i.e., 
the  NODES)  do  not  have  to  be  in  a  straight  line  perpendicular  to 
the  flow.  Since  the  equations  are  continuous  in  space,  which  is 
characteristic  of  the  finite  element  method,  the  computation 
points  can  fall  in  a  random  pattern.  However,  it  is  desirable  to 
be  systematic,  so  that  many  times  the  nodes  will  appear  to  lie 
along  cross  sections  perpendicular  to  the  flow. 


18.  In  coding  cross  sections  for  1-D  computations,  as  many 
as  100  points  are  sometimes  used.  That  is  not  the  case  with  the 
2-D  geometry.  Only  one  elevation  point  is  permitted  at  each 
corner  node  and  the  program  assumes  a  straight-bottom  line  be¬ 
tween  corner  nodes.  Therefore,  if  the  FE  mesh  is  seven  elements 
wide,  the  cross  section  will  be  defined  by  eight  bed  elevations. 
That  may  not  capture  the  true  prototype,  cross-section  geometry. 

19.  On  the  other  hand,  the  1-D  models  solve  simplified 
equations  at  each  cross  section,  whereas  the  2-D  models  solve 
more,  and  more  complex,  equations  at  every  node.  As  a  result, 
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substantial  effort  is  made  in  an  attempt  to  minimize  the  number 
of  nodes  while  adequately  capturing  significant  geometry  and 
hydraulic  features  in  2-D  work. 

20.  The  2-D  hydraulic  code,  like  a  l-D  code,  can  be  run  as 
a  steady-state  solution  or  it  can  be  run  as  a  dynamic  simulation. 
For  a  steady-state  case,  the  tailwater  elevation  is  prescribed 
along  with  the  inflow  of  water  and  the  program  calculates  the 
water  surface,  u-velocity,  and  v-velocity  at  each  node.  Manning 
n-values  are  used  for  friction  roughness  and  turbulent  losses  are 
accounted  for  with  diffusion  coefficients;  calibration  is  re¬ 
quired  to  reproduce  observed  prototype  water-surface  elevations. 
Water-surface  profiles  from  l-D  computations  are  straightforward, 
but  less  so  with  results  from  the  2-D  models.  This  system  will 
plot  a  water-surface  contour  map  of  the  modeled  area.  In  addi¬ 
tion,  velocity  vectors  and  unit  discharge  vectors  can  be  ob¬ 
tained  . 

21.  The  above  discussions  addressed  hydraulic  calculations. 
Sediment  calculations  in  this  system  are  somewhat  less  advanced 
than  those  in  HKC-b  in  some  respects.  For  example,  only  a  single 
grain-size  sediment  can  be  analyzed,  and  armoring  is  not 
addressed.  However,  the  objective  of  calculating  hed-surface 
elevations  for  feedback  to  hydraulics  is  achieved.  Since  calcu¬ 
lations  are  node  by  node,  the  cross-section  shape  can  deform 
depending  on  hydraulics  and  inflowing  sediment  load.  Work  is 
under  way  to  add  more  sophisticated  calculations  to  TAHS-2. 

22.  A  major  difference  between  the  2-D  and  l-D  modeling  is 
the  cost.  A  l-D  model  can  simulate  system  behavior  for  years, 
for  about  the  same  costs  as  the  2-D  model  can  simulate  for  a  few 
days.  It  is  necessary  to  use  a  statistical  approach  to  make 
annual  as  well  as  long-term  projections. 

23.  Neither  the  l-D  nor  the  2-D  sediment  models  are 
designed  tor  local  scour.  It  is  possible,  however,  to  code 
embankment  and  pier  details  into  the  2-D  model  and  calculate  that 
portion  ot  erosion  resulting  from  the  contraction  and  the 
resulting  non  uniform  discharge  distribution.  That  leaves  only 
the  turbulence-generated  scour  as  undefined. 


Origin  of  the  System 


24.  T  A  B  S  -  2  was  assembled  by  personnel  in  the  Estuaries 
Division  and  the  Hydraulic  Analysis  Division,  Hydraulics  Labora¬ 
tory,  US  Army  Engineer  Waterways  Experiment  Station  (WES).  It 
was  operated  on  the  CRAY  1  computer,  Boeing,  Computer  Services, 
trom  1980  through  September  1983  when  the  Corps  of  Engineers 
began  shifting  work  to  CYBERNET  according  to  the  new  contract  for 
ADP  services. 

23.  The  individual  codes  in  the  system  came  from  several 
sources.  The  first  to  be  developed  was  RMA-2.  It  was  completed 
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by  W.  R.  Norton,  I.  P.  King,  and  Gerald  T.  Orlob  in  197  3* **  with 
funding  from  the  Waila  Walla  District,  Corps  of  Engineers. 

Further  details  are  given  in  a  report  to  the  Association  of  Bay 
Area  Governments.*'*  The  modified  code  for  TABS-2  is  presented  in 
the  RMA-2V  appendix  of  this  manual.  In  brief,  the  original 
version  was  a  mass  formulation  and  that  was  changed  to  a  velocity 
formulation  of  the  basic  equations  resulting  in  the  "V"  suffix  on 
the  code  designator  (RMA-2V).  A  capability  to  wet  and  dry  por¬ 
tions  of  the  mesh  also  was  added.  A  number  of  other  revisions 
have  been  made  by  WES  personnel. 

26.  The  sediment  calculations  program,  STUDH,  is  a  WES 
modification  of  the  program  written  by  Ran  j  an  Ariathurai,  Robert 
C.  MacArthur,  and  Ray  B.  Kronet  of  the  University  of  California, 
Davis,  for  the  Dredged  Material  Research  Program  of  the  Corps  of 
Engineers.  That  original  cohesive  transport  mode  1  was  modified 
by  WES  to  transport  sand.  Ariathurai,  who  is  now  with  Resource 
Management  Associates,  modified  his  original  program  for  wetting 
and  drying  and  for  element  shape,  and  his  results  were  incorpo¬ 
rated  into  STUDH  hv  Estuaries  Division  personnel  of  WES.  The  bed 
structure  module,  provision  for  combined  sand-clay  runs,  and 
internal  extrapolation  are  among  many  WES  modifications  to  the 
program. 

27.  The  salinity  transport  program,  RMA-4,  was  obtained 
from  Resource  Management  Associates.  It  was  originally  developed 
for  the  East  Bay  Municipal  Utility  District,  California.  WES  has 
revised  the  program  in  some  ways. 

2H.  The  utility  programs  in  the  systems  came  from  several 
sources.  The  network  generator,  GFC.EN,  is  a  WES  modification  of 
RMA-1,  which  came  from  Resource  Management  Associates.  The  spa¬ 
tial  data  analysis  codes  are  adaptations  of  programs  developed 
hy  V.  E.  LaGarde,  Environmental  Laboratory,  WES.  The  TABS-2  data 
management  system  was  developed  by  WES  Hydraulics  Laboratory 
personnel.  The  automatic  mesh  generator  AI1T0MSH  is  composed  of 
two  codes  obtained  from  Sandia  National  Laboratories,  entitled 
()MKSH  and  RENUM,  plus  WES-generated  interface  codes.  Most  of 
the  other  codes  were  designed  and  written  by  WES  Hydraulics 
Laboratory  personnel. 


*  W.  R.  Norton,  I,  P.  King,  and  G.  T.  Orlob.  1973.  "A  Finite 
Element  Model  for  Lower  Granite  Reservoir,"  prepared  for  US 
Army  Engineer  District,  Walla  Walla,  Wash. 

**  W.  R.  Norton  and  I.  P.  King.  1977.  "Operating  Instructions 
for  the  Computer  Program,  RMA-2,"  Resource  Management 
Associates,  Lafayette,  Calif. 

t  R.  Ariathurai,  R.  C.  MacArthur,  and  R.  B.  Krone.  1977  (Oct). 
"Mathematical  Model  of  Estuarial  Sediment  Transport,"  Techni¬ 
cal  Report  D -77-12,  US  Army  Engineer  Waterways  Experiment 
Station,  Vicksburg,  Miss. 
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Applications 


29.  The  range  of  applicability  of  the  TABS-2  system  is 
still  being  explored.  In  general,  it  should  be  useful  in  subcri- 
tical  flow  systems  in  which  armoring  is  not  a  major  consideration 
and  flow  can  be  described  by  depth-averaged  velocity.  It  has 
been  used  to  model  both  sand  movement  and  the  movement  of  cohe¬ 
sive  material.  It  has  been  applied  in  estuaries,  rivers,  and 
reservoirs,  including  those  listed  below: 

River  Applications: 

Lock  and  Dam  2,  Red  River 
Lock  and  Dam  26,  Mississippi  River 
Greenville  Reach,  Mississippi  River 
Yazoo  Backwater  Area  Pumping  Plant 
Upper  Mississippi  River  Tow  Navigation 
Atchafalaya  River  at  Morgan  City 
Lock  and  Dam  3,  Red  River 
Containment  Area  Design 

Tidal  Applications: 

Columbia  River  Entrance 
Cape  Fear  River 
Atchafalaya  Bay 
Norfolk  Harbor 
Chesapeake  Bay 
New  York  Harbor 
Kings  Bay 

Terrebonne  Marshes 
Charleston  Harbor 
Portsmouth  Harbor 
Corpus  Christi  Bay 


30.  Some  of  these  studies  involved  the  siting  of  training 
structures  to  reduce  navigation  channel  and  harbor  shoaling.  The 
volume  and  location  of  maintenance  dredging  were  key  parameters 
in  comparing  those  alternative  plans.  In  addition,  changes  in 
estuarine  circulation  patterns  and  salinity  intrusion  caused  by 
depth  changes  were  calculated  for  some  of  the  estuarine  areas. 


Limitat ions 


31.  Long  continuous  simulation  studies  are  not  feasible 
because  of  the  computation  cost.  Periods  on  the  order  of  weeks 
or  1 o  n ; ,  e  r  are  modeled  in  piecewise  fashion  with  results  extrapo¬ 
lated  between  successive  periods  of  real-time  modeling.  Study 
areas  should  be  made  as  small  as  practicable  to  reduce  computa¬ 
tional  costs. 
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3  2.  The  2-L)  approximation  involves  integrating  the 
governing  equations  over  depth.  Thus  variations  of  velocity  or 
constituent  concentration  with  depth  are  not  predicted.  De¬ 
pending  upon  the  degree  of  variation  with  depth  occurring  in  the 
waterway  and  the  desired  detail  of  results,  this  approximation 
may  or  may  not  be  an  important  factor. 

33.  Kach  of  the  major  component  programs  in  the  system  has 
specific  limitations.  See  the  documentation  for  each  of  them  for 
their  special  limitations. 


Future  Improvements 


3  A .  This  report  describes  version  2.0  of  the  TABS-2  system. 
The  system  and  its  component  programs  are  undergoing  revision  to 
improve  their  capabilities  and  performance.  Improvements  will  be 
documented  and  reported  to  system  users.  Users  are  encouraged  to 
notify  WES  of  any  improvements  that  they  would  like  to  see  in  the 
programs  or  documentation. 


Related  Systems 


35.  Both  steady-flow  and  unsteady-flow  work  are  being  pack¬ 
aged  in  the  1-D  TABS-1  system.  It  is  designed  for  long-term 
simulations--^)  to  100  years--and  calculates  the  water-surface 
and  the  bed-surface  profiles.  Two  programs  that  approximate  the 
hydrograph  with  a  histogram  of  steady  flows  are  being  considered: 
a  network  version  of  HKC-6  and  quasi-2-D  version  of  HRC-6  (HAD— 1 ) 
in  which  flow  and  sediment  movement  are  calculated  by  strip.  The 
network  code  has  been  applied  to  several  studies,  and  HAD-1  has 
been  applied  to  the  Atcliaf  a  Laya  Delta  and  to  Canton  Reservoir. 

36.  TABS-3  is  the  3-D  version  of  TABS-2;  it  is  presently 
under  development  at  WKS. 

37.  The  TABS-2  system  is  frequently  used  in  conjunction 
with  a  numerical  ship  and  tow  simulator.  The  simulator  consists 
of  a  minicomputer  that  solves  equations  to  simulate  maneuvers  of 
vessels,  a  set  of  pilot  controls,  and  monitors  to  display  visual 
and  radar  scenes  to  the  pilot.  The  ship  and  tow  simulator  is 
described  in  Appendix  C. 


Organization  of  the  Manual 


38.  This  user's  manual  consists  of  the  main  text  and  16 
appendices.  The  main  text  provides  an  overview  of  the  system. 
Appendix  A  is  a  bibliography  on  related  numerical  modeling 
topics;  Appendix  B  is  a  glossary  of  terms  used;  and  Appendix  C 
gives  details  of  one  system  application.  Appendices  D-0  provide 


1  A 


TABS-2 


PART  II: 


SYSTEM  DESIGN 


Capability  of  the  System 


39.  The  primary  considerations  in  developing  TABS-2  were  to 
produce  a  systematic  numerical  method  to: 

•  Establish  relations  between  the  factors  that  cause 

shoaling  problems  in  navigation  channels, 

•  Quantify  the  impact  of  alternatives  being  consid¬ 
ered  to  possibly  reduce  the  amount  of  shoaling 
and  dredging  in  a  navigation  project, 

•  Predict  the  maintenance  required  for  proposed 

new  projects  or  project  improvements. 

That  objective  was  accomplished  by  the  development  of  the  TABS-2 
modeling  system.  In  fact,  the  TABS-2  system  goes  beyond  the 
original  objective  in  that  it  is  capable  of  analyzing  a  consid¬ 
erably  broader  class  ot  problems.  It  is  potentially  useful  for 
planning,  engineering,  and  real  estate  functions  as  well  as 
construction  and  operations.  Hydraulic  computations  can  be  made 
for  fixed-bed  problems,  if  desired,  without  performing  a  sediment 
study  at  all.  The  velocity  field  can  be  calculated  for  a  ship- 
tow  simulator,  for  example,  and  losses  at  channel  junctions  can 
be  calculated.  Flow  around  islands  and  head  loss  at  bridge 

crossings,  particularly  where  multiple  openings  are  involved, 
provide  a  new  design  capability.  The  power  of  the  method  lies  in 
its  ability  to  calculate  the  flow  pattern  across  as  well  as  along 
the  flow  field. 

AO.  TABS-2  is  an  uncoupled  computation  of  the  mobile  bound¬ 
ary  hydraulics  problem.  RMA-2V  is  executed  as  a  fixed-bed  calcu¬ 
lation.  Resulting  hydraulics  parameters  are  passe  <1  to  STUDH 
using  a  file  interface,  and  they  are  used  in  the  sediment  trans¬ 
port  computations.  When  "significant"  bed  changes  are  computed 
by  STUDH,  a  new  set  of  bed  elevations  is  passed  back  to  RMA-2V 
and  hydraulic  computations  are  updated.  (Note:  STUDH  automati¬ 

cally  adjusts  the  magnitude  of  velocities  in  the  RMA-2V  output 
file  in  response  to  calculated  bed  changes.)  The  bed  structure 
in  STUDH  allows  10  layers  at  each  node.  Properties  of  each  layer 
can  be  independently  varied.  Consolidation  with  time  and  over¬ 
burden  is  permitted.  Sand  transport  and  clay  transport  are 
computed  separately. 

Al.  The  SPATIAL  DATA  analysis  programs  offer  a  new  capa¬ 
bility  for  analyzing  and  displaying  field  measurements  as  well  as 
calculated  data  sets.  Of  particular  importance  is  the  capability 
to  subtract  one  spatial  data  set  from  another,  to  summarize  the 
Incremental  changes  between  them,  and  to  display  the  difference 
as  a  contour  plot  or  a  factor  map. 


42.  The  theoretical  basis  for  each  of  the  computer  programs 
is  presented  in  the  appendices  of  this  manual.  In  general, 
hydraulic  computations  can  be  run  in  a  steady-state  mode,  thereby 
producing  a  direct  solution  of  the  equations,  or  they  can  be  run 
as  a  dynamic  simulation.  The  sediment  computations  are  struc¬ 
tured  only  for  the  dynamic  mode. 

43.  Having  the  full  nonlinear  equations  allows  the  hydrau¬ 
lic  computations  to  predict  large-scale  eddies.  However,  these 
codes  are  considered  to  be  far-field  codes;  that  is,  they  are 
not  designed  to  resolve  eddy  and  vortex  problems  close  to  struc¬ 
tures.  There  is  no  t 1 u i d - s t r uc t u r e  interaction  built  into  the 
programs.  On  the  other  hand,  the  codes  can  calculate  the  impact 
of  a  structure,  such  as  a  dike  or  a  bridge  pier,  on  the  current 
pattern;  and  based  on  that  impact,  the  resulting  erosion  or 
deposition  is  calculated. 

44.  iach  finite  element  code  requires  a  computational  mesh. 
Historically,  development  of  the  mesh  has  consumed  enormous 
amounts  of  study  time.  The  implementation  of  automatic  mesh 
generators  in  this  system  provides  a  method  for  streamlining  the 
mesh  generation. 

45.  The  finite  element  method  was  selected  for  this  system 
for  a  number  ot  reasons.  Among  them  are:  (a)  the  solution  is 
continuous  over  the  area  of  interest,  (b)  boundary  condition 
specification  is  extremely  flexible,  (c)  resolution  can  range 
from  very  fine  to  very  coarse  in  the  same  mesh,  (d)  computational 
cells  can  be  oriented  in  many  directions,  and  (e)  model  boundary 
and  interior  shapes  can  he  exactly  represented.  The  latter  two 
reasons  are  particularly  important  in  navigation  channel  studies 
where  size  and  channel  alignment  are  so  variable.  The  finite 
element  approach  allows  computations  to  be  made  node  by  node 
rather  than  averaged  over  an  element. 


Components  of  the  System 


4  (S.  Two-dimensional,  mobile  boundary  hydraulics  problems 
are  considerably  more  complex  than  one  can  address  with  a  single 
computer  program.  Partitioning  the  overall  problem  into  a  set  of 
tasks  led  to  the  tasks  and  computer  codes  listed  in  Table  I. 
Paragraphs  3-7  discuss  the  major  components  briefly.  For  descrip¬ 
tions  of  the  individual  programs,  see  the  appropriate  appendix. 


F  i  1  e  s 


47.  TAHS-2  contains  two  basic  file  subsystems:  (a)  the 

F  E  Subsystem  and  (b)  the  WESDMS  Subsystem.  The  F  K  Subsystem 
files  are  created  by  and  for  the  primary  computation  codes:  the 
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RMA-2V  computer  program  for  hydraulic  calculations,  the  STUDH 
computer  program  for  sediment  transport  calculations,  and  the 
R  M  A  -  4  computer  program  for  dispersive  transport  calculations. 

The  WKSDMS  Subsystem  files  are  used  for  spatial  data  management. 
Consequently,  the  digitizer,  digitial  mapping,  adding  and  sub¬ 
tracting  digital  maps  from  one  another  to  get  shoaling  or  scour 
volumes,  etc.,  use  the  WKSDMS  Subsystem  files.  The  vector  anti 
contour  plotting  programs  can  read  files  from  either  subsystem. 
Interface  programs  are  available  for  transferring  data  from  one 
of  these  file  subsystems  to  the  other.  These  programs  are  de¬ 
scribed  in  Appendix  M:  Interfaces  and  in  Appendix  L:  Data 

Management  System  A.  The  file  structures  are  described  in 
Appendix  N:  Files  and  KMS. 

48.  The  finite  element  computer  codes,  which  make  up  the 

primary  computation  programs  in  TABS-2,  are  linked  together  by 
files.  For  example,  the  geometry  of  the  study  area  is  digitized 
and  processed  during  the  finite  element  network  generation  task. 
The  resulting  file  is  saved  for  use  by  the  RMA-2V  flow  model,  by 
the  STUDH  sediment  transport  model,  by  the  RMA-4  transport  model, 
and  by  various  utility  programs  in  the  systems.  The  geometric 
data  file  structure  is  described  in  Appendix  N:  Files  and  FMS. 

49.  Tiie  flow  model  produces  a  file  of  hydraulic  parameters 
that  is  read  hy  the  sediment  transport  model,  by  the  salinity 
transport  model,  and  by  the  utility  programs.  The  file  structure 
is  described  in  Appendix  N  under  Flow  Model  Files. 

'SO.  The  sediment  transport  model  produces  a  file  of  concen¬ 
trations  and  bed  elevation  changes  that  can  be  road  by  the  sedi¬ 
ment  utilities.  In  addition,  it  produces  an  updated  finite 
element  network  file  that  has  the  new  bed  elevations  calculated 
by  the  sediment  transport  model.  The  new  file  can  be  read  by  the 
flow  model.  These  files  are  described  in  Appendix  N  under  Sedi¬ 
ment  Model  Files. 

51.  The  Transport  Model  produces  a  file  of  concentrations 
that  can  be  read  by  the  contour  program.  This  file  is  described 
in  Appendix  N  under  the  section  Transport  Model  Files. 

52.  Numerous  other  files  can  be  produced.  These  are  de¬ 
scribed  in  Appendix  N  also. 


Structure  of  the  Geometry  Data  Base 

51.  The  computer  program,  "Water-Surface  Profiles"  (HEC-2), 
produced  hy  the  Hydrologic  Kngineering  Center,  has  set  a  standard 
tor  geometry  data  because  of  its  widespread  use  both  in  and  out 
<>  t  the  Corps  of  F.  ngineers.  However,  that  data  structure  requires 
only  two  of  the  three  spatial  coordinates.  TABS-2,  on  the  other 
hand,  requires  all  three  spatial  coordinates;  and  the  data  file 
structure  is  established  by  the  Flow  Model,  RMA-2V.  It  is  com¬ 
pletely  d  i  t  f  e  r  e  n  t  from  H  F.  C  -  2  ,  as  can  be  seen  by  compar  i  ip;  the 


flow  model's  file  structure  in  Appendix  N  with  the  H  E  C  -  2  manual. 


Data  Management 


54.  Data  management  is  essential  to  a  we  1 1 -e xe c u t e d 
numerical  model  study.  The  TABS-2  data  management  system  (DMS) 
is  quite  specialized  for  numerical  modeling  studies,  but  it  also 
contains  some  parts  that  are  applicable  to  a  wide  range  of 
engineering  studies. 


55.  Data  management  in  TABS-2  is  accomplished  in  several 
ways  at  the  user's  choice.  The  WES  Data  Management  System  A  is 
used  to  process,  store,  and  manipulate  spatially  distributed 
data. 


5<5.  The  TABS-2  DMS  consists  of: 


a.  Manual  data  handling  procedures. 

b^.  G  ridding  and  grid  transformation  programs. 

c^.  Programs  to  perform  data  manipulation  and  display. 

d_.  Files  management. 

Items  a-c  above  are  described  in  Appendix  L:  Data  Management 

System  A.  Item  d^  is  described  in  Appendix  N:  Files  and  FMS  and 

in  Appendix  0:  PROCLV. 


Job  Control  Language  (PKOCLV) 


57.  The  TABS-2  system  Includes  a  procedure  file  that  is 
invoked  from  an  interactive  terminal  and  automatically  writes 
job  control  language  (JCL)  to  cause  any  program  in  the  system  to 
be  executed,  assigns  input  files,  saves  output  files,  and  routes 
results  to  the  appropriate  device.  Only  one  line  of  information 
is  needed.  Details  for  using  this  procedure  are  presented  in 
Append i x  0. 
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5H.  TABS -2  is  a  v  a  i  1  a  b  1  e  .it  the  primary  computer  site  tor 
tiie  Corps  of  Engineers.  Interested  users  should  notify  tile  Chief 
of  the  Hydraulic  Analysis  Pi  vis  ion  of  the  Hydraulics  Laboratory 
at  WES. 

b  9 .  The  system  is  maintained  on  the  Corps  contract  computing 
site,  which  is  presently  CYBERNET.  Library  versions  of  the 
programs  and  procedure  files  art*  stored  on  the  TABS -2  user  num¬ 
ber.  Approved  users  are  given  road  and  execute  permissions  for 
the  system  programs. 

b  0 .  PROCLV,  the  procedure  file  used  to  generate  job  control 
language'  and  submit  batch  jobs,  is  transferred  to  each  user's 
number  and  installed  there.  The  installation  procedure  customizes 
FROCI.V  to  the  user's  needs. 


Summary  of  Stops 


hi.  This  section  summarizes  the  steps  in  applying  TABS- 2. 
Details  tor  step  3  and  following  steps  are  presented  in  the 
appendices  of  this  report  where  each  code  is  described.  A  more 
detailed  list  of  steps  is  given  in  Table  2.  The  following  steps 
assume  that  access  to  the  system  has  been  established. 


Step  1 


STATEMENT  OF  PURPOSE  AND  END  PRODUCT 


b  2 •  For  the  most  part,  numerical  modeling  answers  questions 
posed  by  the  modeler  rather  than  simulates  the  behavior  of  the 
proposed  prototype  project.  Rarely  will  it  "surprise"  the  mod¬ 
eler  with  unexpected  problems.  Consequently,  the  questions  to  ask 
of  the  model  must  be  formulated  before  the  study  gets  under  way. 
Other  (pies t ions  usually  surface  as  the  study  progresses,  hut  the 
desired  end  product  of  the  study  needs  to  be  specified  at  the 
b e  g  inning. 


Step  2  . 


FIELD  DATA  ACQUISITION 


b  1 .  This  is  self-explanatory  except  for  L  h  e  question  "What 
data  are  needed.'"  In  general,  the  same  prototype  data  are  re¬ 
quired  for  a  numerical  model  study  as  are  required  for  a  physical 
model  mlv:  geometry,  roup,  line  s  s  ,  structures  and  other  man-made 

changes,  hvdrolngv,  sedimentation,  hydraulic  character,  develop¬ 
ment  p I  a  n  s  t  operational  policies,  and  performance  criteria.  A  P  — 

P  !•.  0  F  X  Discusses  f  i  e  1  d  data  col  lecti  o  u  . 


LAYOUT  AND  DESIGN 


a  v  o  u  f  ,  entitled  N 


urk  Generation  in  Appendix  D, 


begins  by  defining  the  model  limits.  They  should  extend  several 
river  widths  on  either  side  of  the  study  area  so  the  parameters 
prescribed  as  boundary  conditions  will  be  outside  the  influence 
of  changes  occurring  in  the  study  area.  The  next  task  is  to 
sketch  the  desired  mesh  on  an  overlay  and  establish  regions 
having  similar  hydraulic  properties.  Then,  digitize  the  boundary 
around  each  region  for  input  into  the  mesh  generator.  The  output 
from  the  mesh  generator  is  combined  with  card  image  run  control 
data,  without  bed  elevations,  and  input  into  GFGEN  where  the 
curved  boundaries  of  the  mesh  are  calculated  and  elements  are  re¬ 
ordered  for  more  efficient  computations.  The  output  file  from 
GFGKN  is  the  network  needed  hy  RMA-2'’  except  bed  elevations  are 
usually  not  yet  coded.  Bed  elevations  can  be  input  from  the 
beginning,  but  it  is  not  recommended.  Normally,  run  the  RMA-2V 
"leak"  test  at  this  point  by  assuming  the  bed  is  at  elevation 
"zero"  or  some  other  appropriate,  constant  value.  Running  a 
flat-bottom  leak  test  first  will  shorten  total  study  time.  The 
final  step  in  network  generation  is  to  determine  the  bed  eleva¬ 
tion  at  each  corner  node  in  the  mesh. 

Step  4.  RUN  LEAK  TEST  IN  RMA-2V 

6b.  The  purpose  of  the  leak  test  is  to  check  the  mesh, 
boundaries,  and  boundary  condition  types  for  leaks.  The  perform¬ 
ance  criterion  is  continuity  of  water.  The  approach  is  to  estab¬ 
lish  a  condition  of  a  horizontal  pool  and  an  inflow  velocity,  or 
discharge,  equal  to  zero.  If  water  leaks  out  of  the  network, 
either  the  network  or  boundary  conditions  contain  errors.  A 
second  leak  test  with  actual  bottom  elevations  is  performed  as  a 
final  check  on  network  adequacy.  Details  are  given  in  the  RMA-2V 
user  instructions,  Appendix  F. 

Step  5.  ESTABLISH  THE  INITIAL  CONDITIONS 

6b.  Initial  conditions  refer  to  the  intial  depths  of  water 
and  velocity  at  every  node.  The  first  choice  is  always  a  con¬ 
stant  elevation  and  zero  velocity  because  that  is  easiest  to 
code.  If  computations  converge  that  approach  is  successful,  but 
if  computations  fail  to  converge  use  the  HOTSTART  procedure 
explained  in  the  RMA-2V  documentation. 

Step  6.  RUN  TESTS  IN  RMA-2  V 

67.  Testing  always  starts  with  verification  to  field  or 
other  appropriate  data.  After  this  point,  the  desired  tests  are 
run.  The  most  difficult  task  in  running  tests  is  maintaining 
adequate  documentation  of  what  is  being  tested,  the  results,  and 
h o  w  this  test  differs  from  those  before  and  after  it.  Careful 
note-keeping  is  strongly  recommended  and  some  techniques  are 
described  in  the  appendices,  particularly  Appendix  N . 

Step  7.  RUN  TESTS  IN  STUDH 

6  H .  There  is  no  leak  test  for  STUDH,  hot  it  is  important  to 
establish  a  sequence  of  tests  that  start  with  a  simple  condition 
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and  proceed  toward  the  more  complex.  Attempt  to  define  a  case 
in  which  a  steady-flow  water  discharge  and  a  steady-state  sedi¬ 
ment  concentration  at  the  boundary  can  be  run  with  negligible 
change  in  the  bed  elevations.  When  that  case  runs  satisfactori¬ 
ly,  begin  time -dependent  boundary  conditions  or  flow  field  runs. 
Always  limit  changes  to  one  parameter  at  a  time.  Details  for 
running  STUDH  are  presented  in  Appendix  C . 

Step  8.  CYCLE  BETWEEN  STUDH  AND  RMA-2V 

69.  The  STUDH  program  will  produce  a  new  geometry  file  that 
can  be  cycled  back  through  RMA-2V  as  needed.  A  general  rule  of 
thumb  is  to  allow  the  bed  surface  to  change  by  a  foot  or  10 
percent  of  the  depth  before  rerunning  RMA-2V,  but  each  study  must 
be  prepared  to  modify  that  general  rule  if  results  so  indicate. 

Study  Management 

70.  Key  words  appropriate  for  2-D  numerical  modeling 
studies  are  plan-moni tor-evaluate .  An  inadequate  plan  of  study 
will  often  cause  the  study  time  to  increase,  thereby  increasing 
manpower  and  computer  costs.  Inadequate  monitoring  of  ADP  usage 
can  allow  the  entire  annual  budget  for  ADP  to  be  spent  early  in 
the  project.  Inadequate  evaluation  of  study  results  will  lead  to 
misinterpretation.  This  type  of  study  will  produce  many  more 
numbers  than  the  engineer  is  historically  accustomed  to,  so  the 
procedures  for  evaluating  results  must  be  carefully  thought  out. 

71.  The  review  of  results  produced  by  2-D  numerical  models 
should  always  include  volumes  or  total  masses  as  well  as  the 
rates  and  distributions  which  are  calculated  and  printed  out  by 
the  programs.  Always  ascertain  that  the  geometry,  as  defined  by 
connecting  the  (x,y,z)  coordinates  of  the  finite  element  network 
with  a  series  of  planes,  closely  approximates  the  prototype,  that 
n-values  are  assigned  in  accordance  with  standard  procedures  for 
estimating  hydraulic  roughness,  and  that  the  diffusion  coeffi¬ 
cients  are  reasonable.  Although  mentioned  last,  the  diffusion 
coefficients  issue  is  by  no  means  of  least  importance.  Head  loss 
at  contractions  and  eddy  formations  are  strongly  controlled  by 
the  diffusion  coefficients.  Often,  a  sensitivity  study  is  the 
only  method  for  testing  the  role  the  diffusion  coefficients  play 
in  the  results  of  a  particular  study. 


PART  IV: 


EXAMPLE  PROBLEM 


72.  Appendix  C  contains  an  example  problem  that  illustates 
the  steps  in  applying  TABS-2.  The  following  example  uses  the 
results  of  an  application  on  the  Mississippi  River  near 
Greenville,  Mississippi,  to  briefly  illustrate  model  performance. 

73.  The  Greenville  Reach  of  the  Mississippi  River  starts  at 
the  Greenville  Bridge,  river  mile  531.33,  and  extends  about  15 
miles  upstream  (Figure  3).  The  Potamology  Research  Section,  US 
Army  Engineers  Division,  Lower  Mississippi  Valley,  developed  the 
computational  network,  provided  hydrographic  survey  data,  flow 
velocities,  float  measurements,  and  water-surface  elevations  for 
testing  the  performance  of  the  RMA-2V  code  for  hydraulic  calcula¬ 
tions.  Results  of  that  application  are  presented  below. 


Figure  3.  Vicinity  map,  Greenville  roach, 
Mississippi  River 


TABS-2 


75.  Another  type  of  dike  in  the  Greenville  reach  is  the 
vane  dike.  It  is  positioned  in  the  channel  at  a  slight  angle  to 
the  current  and  is  not  attached  to  the  bank.  There  are  five  vane 
dikes  in  the  Greenville  reach,  each  one  requiring  four  elements 
to  model  its  shape  and  size.  The  resulting  mesh  provided  the 
necessary  resolution  for  the  computations. 

76.  The  hydrographic  survey  of  9  March  1981  was  digitized 
and  incorporated  in  the  computation  mesh.  Depths  ranged  from  5  to 
75  ft.  The  corresponding  water  discharge  and  water-surface  ele¬ 
vation  at  the  Greenville  Bridge  gage,  677,500  cfs  and  104.2  ft 
NGVD,  respectively,  were  encoded  as  boundary  conditions.  The  n- 
values  and  eddy  viscosity  coefficients,  E  ,  were  assigned  as 
follows: 


Feature 

n- Va 1 ue  s 

ixx 

-yy 

Ixy 

JLyx 

River  channel  elements 

0.0275 

250 

250 

250 

250 

Dike -field  elements 

0.043 

250 

250 

250 

250 

Van  e-dike  elements 

0.045 

250 

250 

250 

250 

Other  dike  elements 

0.055 

250 

250 

250 

250 

77.  Three  model  responses  were  oberved:  Water-surface 
elevations,  current  patterns/velocity  d  stributions,  and  unit 
discharge  at  a  cross  section.  Model  and  prototype  water  surfaces 
are  shown  in  Figure  5.  Model  results  were  within  1/2  ft  of  the 


WATER  SURFACE  ELEVATIONS 
FEET  NGVD 

PROTOTYPE  MOOEl 


111.8 

111.3 


1097 

109.4 

108.4 

108.4 
108.8 
108.3 

109.2 

107.2 

106  0 
104  2 


-0.5 

-0.1 


-0.1 

-0.1 

0.0 

-0.1 

-1.0 

-0.3 

-1.0 

-0.2 


GREENVILLE  REACH  (Q  -  677,500  CFS,  9  MARCH  1981) 


Figure  5  .  Water-surface  elevations 
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prototype  except  for  three  gages  where  the  difference  ranged  up 
to  1  ft.  Most  gages  were  within  a  tenth  of  a  foot.  In  addition 
to  the  tabular  data  at  gages,  contours  of  the  water  surface  were 
developed.  Of  particular  interest  is  the  steep  gradient,  on  the 
inside  of  the  bend,  between  elevation  109  and  111. 

78.  Figure  6  shows  the  model  velocity  vectors  near  Tarpley 
Island.  The  dots  are  float  positions  taken  at  30-sec  intervals. 
Vector  lengths  were  scaled  so  perfect  agreement  is  three  dots 
long.  The  results,  both  in  magnitude  and  direction,  were  very 
good.  (Note  the  eddies  forming  downstream  of  the  Tarpley  Island 
Dike.) 

79.  Not  only  velocity  vectors  but  also  flow  distribution 
matched  prototype  data  remarkably  well  as  shown  in  Figure  7.  The 
calculated  flow  distribution  around  Tarpley  Island  matches 
prototype  measurements  within  2  percent. 

80.  Figure  8  shows  two  vector  plots--one  for  velocity  and 
one  for  unit  discharge.  To  obtain  greater  readability,  the 
horizontal  scale  is  compressed.  Both  plots  show  the  greatest 
intensity  crossing  from  the  left  bank  to  the  right  bank  just 
upstream  from  Greenville  Bridge.  The  unit  discharge  vectors  show 
a  narrow  band  of  high  discharge  that  is  of  importance  to  sediment 
and  channel  alignment  studies,  whereas  the  velocity  vectors  show 
the  most  information  for  navigation  studies. 

81.  In  general,  the  codes  performed  well.  Wetting  and 
drying  of  elements  caused  some  numerical  problems  that  can  only 
be  solved  by  relatively  small  element  sizes  at  present.  The 
application  took  about  2  months  and  served  as  a  training  aid  in 
addition  to  testing  the  code  performance. 
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Figure  f>.  Comparison  ot  model  and  prototype 
velocities,  Greenville  reach 
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GREENUILLE  REACH 

COMPARISON  OF  MEASURED  AND  COMPUTED  FLCU  DISTRIBUTION 
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3000  3000 

STATIONS#  FT. 
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Figure  7.  Flow  distribution  comparison 


TABS-2 


28 


PART  V: 


INDEX  OF  PROGRAMS 


82.  Several  indices  are  provided  to  help  the  user  locate 
programs  within  this  manual.  An  index  of  programs  by  categories 
appears  after  the  table  of  contents.  Table  1  lists  the  major 
task  categories  and  the  programs  that  accomplish  those  tasks. 
Table  3  lists  the  programs  and  procedures  by  name  and  gives  the 
manual  location  that  describes  their  use.  Each  appendix  contains 
a  table  of  contents  listing  the  programs  contained  there. 
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Table  1 

TABS-2  Tasks  and  Programs 


_ Task _ 

DIGITIZING 

MESH  GENERATION 

FLOW  MODELING 

SEDIMENT  MODELING 

TRANSPORT  MODELING 

SPATIAL  DATA 
MANAGEMENT 

GRAPHICAL  OUTPUT 

OUTPUT  ANALYS IS 

FILE  MANAGEMENT 

INTERFACES 

JOB  SUBMISSION 


o 


O 


o 

o 

o 

o 

o 


o 

o 

o 

o 


o 


o 


o 


o 

o 


Purpose 


Computer 

Programs 


Create  a  digital  map  of  the  study  area  in  (x,y,z)  MESH 
coordinates.  DMSDIG 

Establish  the  (x,y)  coordinates  for  the  boundary 
around  the  finite  element  mesh  and  in  complex 
studies,  boundaries  of  each  subregion  in  that  mesh. 


Locate  computation  nodes  in  the  study  area  and  AUTOMSH 

link  them  together  into  elements.  CFGEN 

Assign  element  types,  first  external  boundary  EDGRG 

nodes,  calculate  curved  sides,  and  produce  the 
input  file  for  RMA-2V  geometry  in  the  proper  forms 

Calculate  wa t e r -s u r f ac e  elevation,  the  RMA-2V 

u-velocity  and  the  v-velocity  for  a  specific 
set  of  boundary  conditions. 

Calculate  the  concentration  of  sediment  in  STUDH 

the  flow,  erode  transport  and  deposit,  and 
change  bed  elevations  at  each  node. 

Calculate  the  salt,  temperature,  orother  RMA-4 

constituent  concentration  in  the  flow  field. 


Transform  randomly  spaced  data  to  a  uniform  ELEVGRD 

grid  (i.e.,  such  as  velocities  from  RMA-2V 
to  a  uniform  spacing  for  plotting). 

Interpolate  gridded  data  from  one  cell  sire  TRANSA 

to  another. 

Interpolate  from  gridded  data  to  irregularly  RETPNT 

spaced  points  (i.e.,  such  as  extracting 
nodal  elevations  from  the  digital  map  file). 

Subtract  two  spatial  data  sets.  GKDSUB 

Create  a  factor  map.  F ACC K D 


Plot  velocity  vectors. 
Plot  contour  maps. 

Plot  drogue  path  from 
KMA-2V  output. 


V  PLOT 
CONTOUR 
OROGUEPLOT 
SEDGRAF 


Analytical  and  statistical  summaries. 
Comparisons  or  one  data  set  or  result  with 
another  -  as  model  to  prototype. 
Accumulations  of  rates  into  volumes. 


POSTSED 

POSTHY  !) 
ACE 


Score,  retrieve,  and  provide  common 
analysis  of  temporal,  spatially 
distributed  data  sets. 

Maintain  a  history  and  "family  tree 

information'’  of  the  contents  in  a  tile. 


Change  output  from  one  code  into  form 
required  to  input  to  another, 
lobstream  model  runs  from  coarse  meshes 
to  inset  meshes. 


KNGMKT 

JOBS  THE  AM 


Automatic  )ob  control  language.  PKOCI.V 

Submit  hatch  jobs  to  computer. 

Track  job's  progress. 
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Table  2 

Summary  of  Steps  for  a  Typical  Applications 

1.  Prepare  statement  of  purposes  and  end  products  desired. 

2.  Assemble  available  prototype  information--charts,  maps, 

flow  measurements,  etc. 

3.  Sketch  mesh  limits  and  element  layout. 

4.  Refine  mesh  sketch,  number  nodes  and  elements  (manually  or 

by  AUTOMSH),  and  set  up  connection  table. 

5.  Establish  boundary  condition  nodes. 

6.  Identify  nodes  on  curved  boundaries  and  assign  slopes. 

7.  Digitize  manually  developed  mesh  or  region  boundaries  for 

automatic  mesh  generation. 

8.  Edit  and  merge  files  for  CFGEN  input. 

9.  Run  GFGEN  or  (EDGRG),  then  edit  slope  error  problems. 

10.  Rerun  GFGEN  until  all  major  slope  errors  are  fixed  and 

network  is  reordered  efficiently. 

11.  Create  RMA-2V  run  control  file  for  s t e ad y- s t a t e ,  flat-bottom 

leak  test  and  run. 

12.  If  mesh  leaks,  correct  problems. 

13.  Install  actual  bed  elevations,  then  rerun  leak  test. 

Correct  leaks  and  oozes. 

14.  Run  RMA-2V  verification  tests. 

15.  Run  RMA-2V  base  test. 

16.  Create  STUDH  run  control  file  with  nonerodible  bed  and 

constant  boundary  concentrations.  Run  short  test  and 
correct  any  problems  that  occur. 

17.  Modify  STUDH  run  control  file  to  show  desired  bed  condition 

and  initial  and  boundary  conditions.  Run  initial  test  and 
correct  any  problems  that  appear. 

18.  Run  STUDH  verification  tests. 

19.  Run  STUDH  base  tests. 

20.  Revise  computational  roesh  as  needed  for  plan  to  be  tested. 

21.  Run  RMA-2V  plan  tests. 

22.  Produce  graphical  and  tabular  hydrodynamic  results  output. 

23.  Run  STUDH  plan  tests. 

24.  Produce  graphical  and  tabular  sedimentation  results  output. 


C,J 


25.  Report  results. 


Table  3 

Program  Name  Index 


PROGRAM 

PURPOSE 

APPENDIX 

PAGE 

ACE 

Assemble  STUDH  events,  compute  bed 
change  and  dredging  volumes,  plot 
sediment  transport  vectors. 

J 

J-  1  -  1 

All  TOMS  II 

Create  computational  meshes. 

D 

D-l-1 

BATHVOL 

Compute  volume  of  sediment  difference 
between  two  surveys. 

L 

L-l 5-  1 

BIN2FOR 

Transform  binary  model  output  files  to 
f  o  rma  t  ted  files. 

J 

J-  3-  1 

BTHARKA 

Compute  areas  within  contours. 

L 

1 

\ 

CONFEG 

Convert  digitizer  file  to  GFGEN  format 

E 

E-3-1 

CONTOUR 

Plot  contour  map  of  specified  data. 

1 

l-l-l 

DROGUE  PLT 

Plot  path  of  a  drogue  moving  with 

current . 

l 

l-2-l 

DMS  IMG 

Digitize  data  from  a  map  or  graph. 

L 

L-l-l 

UGPLT 

Plot  digitized  data  for  checking. 

L 

L-  2  -  1 

D  I  R  E  C  T 

Display  a  plot  on  a  graphics  device. 

1 

1-3-1 

DUMPER2 

Print  g ridded  data  in  swaths. 

L 

L- 1 b- 1 

E  1)0  RG 

Edit  computational  network  interactive 

ly .  D 

D-  2  -  1 

K  L  K  V  G  R  U 

Create  standard  DMS  data  format  file 
from  randomly  spaced  data. 

L 

L-  1  0-  1 

ENGMET 

Translate  RMA-2V  output  from  English 
units  to  SI  units  for  use  by  STUDH. 

M 

M-  1  -  1 

F  N  UNO  l)  K 

Co  cate  a  node  in  a  computational  mesh. 

I) 

D  -  3  -  1 

K  ACGRD 

Set  up  factor  or  patch  map. 

1, 

L-  1  2-  1 

F02UN 

Transform  formatted  tile  to  DMS  binary 
form. 

L 

L-  3-  1 

F  0  R  ?  B  I  N 

Transform  formatted  model  output  files 
to  binary  files. 

J 

J-4-  1 

4  V  l  E  W 

Plot  psuedo-3-D  graphs. 

1 

1-4-1 

(Continued) 
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Table  3  (Continued) 


PROGRAM 


G  FGKN 


G  C  S  /  M  K  T  A 


c;rdsuh 


JOBSTRKAM 


M  K  S  H  1 


M  K  S  H  2 


M  E  S  H  3 


MKTAPLOT 


POSTHYD 


POSTS  K 1) 


P  ROCLV 


R  K  T  P  N  T 


RK  FMT 


K  M  A  -  2  V 


R  M  A  -  4 


S  K  DO  RAF 


S  T  U  f)  H 


PURPOSE 


Accumulate  STUOH  output  results  tor 
use  by  ACE. 

Create  geometric  data  file  for  use  by 
models  . 

MKTAPLOT  version  of  GCS . 

Subtract  one  set  of  gridded  data  from 
another  and  writes  results  to  a  file. 

Compute  boundary  conditions  for  an 
inset  computational  network  from 
results  of  a  larger  network  model  run. 

Merge  tabular  data  into  a  gridded 
data  set. 

Merge  standard  hydrographic  survey 
data  into  a  gridded  data  set. 

Merge  gridded  data  from  several  maps. 

Produce  graphics  output  files. 

Analyze  results  of  an  RMA-2V  run  and 
plot  time- histories. 

Summarize  results  of  a  S  T  U  D  H  run. 

Construct  job  control  language  and 
submit  batch  jobs  to  run  programs. 

Interpolate  gridded  data  to  provide 
data  at  specified  points. 

Convert  special  digitizer  data  files 
to  standard  format. 

Compute  2-D  flow  and  water  levels 

Compute  transport  of  dissolved  and 
suspended  substances. 

Produce  factor  map  of  STUOH  results. 

Compute  transport,  erosion,  and 
deposition  ot  sediments. 
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J-  1  -  1 


D-3-1 


1-5-1 


L-l 3-1 


M  -  2  -  1 


L-  7  -  1 


L-8-1 


L  —  9  —  i 


1-6-  1 


J-3-1 


J  -  2  -  1 


L-l 1-1 


L-3-  1 


1-3-1 


T  A  B  S  -  2 


PROGRAM 

PURPOSE 

APPENDIX 

TRANSA 

Transform  data  from  one 
another . 

^  r  i  d  system  to 

1. 

U  N  2  ¥  0 

Transform  binary  form  data  to 
formatted  form. 

E 

V  PLOT 

Produce  vector  plots  of 
velocity  results. 

RMA-2 V 

I 

PAGE 
L-4-  1 

L-6-  1 

I  -  7  -  1 


WDGPET 


Plot  wet  and  dry  areas  of  computational 


I 
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APPENDIX  B:  GLOSSARY 


This  glossary  presents  definitions  of  some  of  the  terms  used 
in  this  manual.  The  definitions  are  sometimes  limited  to  how  the 
work  is  used  in  the  manual  instead  of  a  general  definition.  Also 
included  are  some  related  modeling  definitions  that  are  quoted 
from  an  American  Society  of  Civil  Engineers  task  committee  re¬ 
port,  "Modeling  Hydraulic  Phenomena:  A  Glossary  of  Terms”  (July 

1082,  Journal  of  the  Hydraulics  Division,  Vol  108,  HY7).  Those 

definitions  are  marked  with  "(ASCE)“  after  the  definition.  Since 
WKS  Hydraulics  Laboratory  personnel  participated  in  that  task 
committee,  many  of  the  definitions  are  consistent  with  TABS-2 
use. 


ACCURACY  -  The  difference  between  the  approximate  solutions 
obtained  using  a  numerical  model  and  the  exact  solution  of  the 
governing  equations.  (ASCE) 

ADJUSTMENT  -  Variation  of  the  parameters  in  a  model  to  ensure  a 
close  reproduction  by  the  model  of  a  set  of  prototype  conditions. 
(ASCE) 

ALGORITHM  -  A  set  of  numerical  steps  or  routines  to  obtain  a 
numerical  output  from  a  numerical  input.  (ASCE) 

ALIASING  -  Occurrence  of  an  apparent  shift  in  frequency  of  a 
periodic  phenomenon.  It  arises  as  the  consequence  of  the  choice 
of  discrete-space  or  time  sampling  points  to  represent  a  contin¬ 
uous  process.  The  choice  may  introduce  a  spurious  periodic 
solution  or  mask  a  real  periodic  phenomenon.  (ASCE) 

ANALYTICAL  MODEL  -  Mathematical  model  in  which  the  solution  of 
the  governing  equations  is  obtained  by  algebraic  analysis. 

BINARY  DATA-  Data  that  are  stored  in  binary  form  and  not  sepa¬ 
rated  by  spaces  or  other  delimeters.  Binary  data  files  cannot  be 
interpreted  by  mortals. 

BOUNDARY  CONDITIONS  -  Water  levels,  flows,  concentrations,  etc., 
that  are  specified  at  the  boundaries  of  the  area  being  modeled. 

A  specified  tailwater  elevation  and  incoming  upstream  discharge 
are  typical  boundary  conditions. 

BOUNDARY  CONDITIONS  -  Definition  or  statement  of  conditions  or 
phenomena  at  the  boundaries.  (ASCE) 

BOUNDARY  EFFECT  -  Consequence  of  dissimilarities  between  the 
model  boundary  conditions  and  the  conditions  occurring  in  the 
prototype  at  the  location  of  the  model  boundaries.  (ASCE) 
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Gl.  OSSARY 


CA1.C0MP  -  A  proprietary  line  of  graphics  devices  and  software 
that  are  recognized  as  standard  in  computer  graphics 
applications. 


CALIBRATION  -  Adjustment  of  a  model's  parameters  such  as  rough¬ 
ness  or  dispersion  coefficients  to  make  it  reproduce  observed 
prototype  data. 

CARD  -  A  cardboard  input  medium  that  is  not  generally  used  by 
TABS-2.  The  input  data  are  organized  into  lines  of  information 
and  each  line  (a  card  image)  is  called  a  card. 

CARD  I  M  A  C  E  DATA  -  Information  that  is  to  be  read  by  a  program  as 
input.  The  information  is  punched  on  computer  cards  or  keyed 
into  a  file  that  contains  one  line  of  information  corresponding 
to  each  read  statement  in  the  program. 

CHARACTERISTICS  METHOD  -  Method  in  w  h  i  c  h  t  h  e  governing  partial 
differential  equations  of  a  mathematical  model  are  transformed 
into  characteristic  (ordinary  differential)  equations. 

CODED  DATA  -  Data  that  are  stored  in  ASCII  form  and  are  thus 
readable  by  ordinary  means,  e.g.,  a  text  editor  program. 

COLD  START  -  A  model  run  using  initial  conditions  that  are  not 
expected  to  be  close  to  conditions  as  solved  by  the  model,  e.g., 
a  level  water  surface  and  zero  velocities. 

C0NCKPTUA1  MODEL  -  A  simplification  of  prototype  behavior  used  to 
demonstrate  concepts.  (  A  S  C  K ) 

CONFIRMATION  -  Process  in  which  a  model  of  a  specific  design  is 
built  and  tested  to  confirm  that  a  design  is  adequate  and  no 
major  phenomenon  has  been  overlooked. 

CONSISTENCY  -  The  choice  of  a  set  of  approximations  that  yield  a 
solution  in  which  the  approximations  are  subsequently  justified. 
For  example,  the  assumption  of  linearity  can  be  tested  for 
consistency  by  checking  the  relative  magnitude  of  the  n  e  g 1 e  c  t  e d 
or  linearized  terms  using  the  derivative  solution.  (ASCE) 

CONVE  RC.ENCE  -  The  state  of  tending  to  a  unique  solution.  A  given 
scheme  is  convergent  it  an  increasingly  finer  c  o  m  p u  t  a t  o  n  a  1  grid 
leads  to  a  more  accurate  solution.  (ASCE) 

D  E T K R  M  I  N  I  S  T  I  C  MODEL  -  Mathematical  model  in  which  the  behavior  of 
every  variable  is  completely  determined  by  the  governing  equa¬ 
tions.  (ASCE) 

II  I  0  [  T  I  /.  AT  I  ON  -  Representation  of  a  continuous  process  by  numeri¬ 
cal  (digital)  values.  (ASCE) 

I)  1 0  l  T  1 7.  F.  -  Convert  data  from  map  or  graphical  form  to  digital 
form  for  use  by  the  programs. 
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DIRECT  SCHEME  -  Scheme  for  finding  values  of  certain  dependent 
variables  at  given  values  of  the  independent  variables  and  time 
(“dependent  variable  scheme").  (ASCE) 

DISCRETIZATION  -  The  procedure  of  representing  a  continuous  vari¬ 
able  by  discrete  values  at  specified  points  in  space  and/or  time. 


DISCRETIZATION  ERROR  -  Error  introduced  by  the  discrete  represen¬ 
tation  of  a  continuous  variable. 

DISSIPATIVE  SCHEME  -  Computational  scheme  designed  to  damp  or 
eliminate  numerical  production  of  energy.  (ASCE) 


DYNAMIC  MODEL  -  A  mathematical  model  in  which  the  independent 
variables  are  adjusted  to  allow  for  the  influence  of  time- 
dependent  behavior  of  the  dependent  variables.  (ASCE) 

EMPIRICAL  MODEL  -  Representation  of  a  real  system  by  a  mathemati¬ 
cal  description  based  on  experimental  data  rather  than  on  general 
physical  laws.  (ASCE) 

EXPLICIT  SCHEME  -  Scheme  in  which  the  governing  equations  of  a 
numerical  model  are  arranged  to  update  the  dependent  variable 
explicitly  in  terms  of  previously  known  values.  (ASCE) 

FILTERING  -  The  procedure  of  removing  or  smoothing  un desired 
perturbations.  (ASCE) 

FINITE  DIFFERENCE  METHOD  -  Method  in  which  differentials  of  the 
governing  equations  of  a  numerical  model  are  written  and  solved 
in  finite  difference  form. 

FINITE  ELEMENT  METHOD  -  Method  of  solving  the  governing  equations 
of  a  numerical  model  by  dividing  the  spatial  domain  into  elements 
in  each  of  which  the  solution  of  the  governing  equations  is 
approximated  by  some  continuous  function.  (ASCE) 

FIXED  FORMAT  -  Input  structure  that  requires  data  to  appear 
within  specified  areas  of  a  line  (  i  .e . ,  specified  "card  columns") 
and  corresponding  to  a  preset  sequence. 

F K  E E -KIEL  D  -  Input  structure  that  requires  a  preset  sequence  of 
data  without  limiting  how  the  data  a  e  written  within  that 
sequence.  Free  —  field  input  variables  may  be  separated  by  commas 
or  spaces. 

GRID  -  Network  of  points  covering  the  space  or  t  i m  e - s  p a e e  d o m  a i n 
o  t  a  numerical  model.  The  points  are  usually  regularly  spaced, 
(modified  ASCE) 

HEURISTIC  MODEL  -  Representation  of  a  real  system  by  a  mathemati¬ 
cal  description  based  on  reasoned,  but  unproven  argument.  (ASCE) 
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HOTSTAKT  -  A  model  run  usIiir  initial  conditions  that  are 
expected  to  be  close  to  conditions  as  solved  by  the  model. 

Usually  these  hotstart  initial  conditions  are  results  saved  from 
a  previous  model  run. 

HYBRID  MODEL  -  Model  combining  at  least  two  modeling  techniques 
(e.g.,  physical  and  numerical)  in  a  closely  coupled  fashion. 

HYDRAULIC  MODEL  -  Physical  model  using  water  as  fluid.  (ASCE) 

IMPLICIT  SCHEME  -  Scheme  in  which  the  governing  equations  of  a 
numerical  model  are  arranged  to  obtain  solutions  for  the  depen¬ 
dent  variable  simultaneously  at  all  grid  points  corresponding  to 
any  one  time.  The  computed  values  depend  not  only  on  known 
values  at  a  previous  instant  in  time  but  also  on  the  other  un¬ 
known  neighboring  values  at  the  surrounding  grid  points  at  time 
being  calculated.  (ASCE) 

INITIAL  CONDITIONS  -  The  value  of  water  levels,  velocities,  con¬ 
centrations,  etc.,  t  h  a  t  are  specified  everywhere  in  the  m  e  s  h  at 
tiie  beginning  of  a  model  run.  For  iterative  solution,  the  ini¬ 
tial  conditions  represent  the  first  estimate  of  the  variables  the 
model  is  trying  to  solve  for. 

INTERACTIVE  MODEL  -  Numerical  model  which  allows  interaction  by 
the  modeler  during  computation. 

LINEAR  MODEL  -  Mathematical  model  based  entirely  on  linear  equa¬ 
tions.  v  A  S  C  E  ) 

LOGICAL  UNIT  -  A  numerical  designation  that  a  computer  program 
interprets  as  a  device  that  it  should  attach  to  read  from  or 
write  to.  In  practice,  where  several  different  files  stored  on 
disk  are  to  be  accessed,  each  file  is  given  a  unique  logical  unit 
number.  Whenever  the  program  is  told  to  read  or  write  on  logical 
unit  14  (sometimes  called  T  A  P  F.  1  4 )  it  somehow  figures  out  where 
that  file  is  a  n  <i  accesses  it. 

MATHEMATICAL  MODEL  -  A  model  that  uses  mathematical  expressions 
to  represent  a  physical  process. 

MESH  -  The  network  of  computational  points  (nodes)  linked 
together  by  the  element  connection  tables  to  lorn  a  digital 
representation  of  the  modeled  areas  geometry. 

MODEL  -  A  representation  of  a  physical  process  or  t  h  i  n  g  t  h a t  can 
he  used  to  predict  the  process's  or  thing's  behavior  or  state. 

(A  story  about  real  1  i  1  e . ) 

E  x  a  m  p  1  e  s  : 

A  c o n r e p  u  t  a  1  model:  It  1  thro  w  a  rock  harder,  it  will 

go  taster. 

A  ti  a  t  h  e  m  a  t  i  e  a  1  m  o  <1  el:  E  -  n  a 
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A  hydraulic  model:  Columbia  River  physical  model 

MOVABLE-BED  MODEL  -  Model  in  which  the  bed  and/or  side  material 
is  erodible  and  transported  in  a  manner  similar  to  the  prototype. 

NETWORK  -  Same  as  mesh. 

NCVD  -  National  Geodetic  Vertical  Datum,  vertical  datum  plane 
re  ter e nee  that  has  replaced  mean  sea  level. 

NONLINEAR  MODEL  -  Mathematical  model  usin)>  one  or  more  non-linear 
equat ions  . 

NUMERICAL  DIFFUSIVITY  -  The  second-order  term  introduced  as  a 
result  of  discretization  of  the  governing  differential  equations 
using  either  forward  or  backward  differences.  (ASCE) 

NUMERICAL  DISPERSION  -  The  effect  on  the  numerical  solution  of 
numerical  diffusivity.  (ASCE) 

NUMERICAL  MODEL  -  A  model  that  uses  numerical  (computational) 
methods  to  obtain  solutions  to  mathematical  expressions. 

ONE-DIMENSIONAL  MODEL  -  Model  defined  on  one  space  coordinate, 
i.e.,  variables  are  averaged  over  the  other  two  directions  (e.g., 
wave  propagation  in  a  narrow  channel).  (ASCE) 

PROBABILISTIC  MODEL  -  Mathematical  model  in  which  the  behavior 
of  one  or  more  of  the  variables  is  either  completely  or  partially 
subject  to  probability  laws.  (ASCE) 

PROTOTYPE  -  The  full-sized  structure,  system  process,  or  phenome¬ 
non  being  modeld.  (ASCE) 

QUASI-STEADY-STATE  MODEL  -  Model  in  which  time-dependent 
variables  are  simulated  by  a  sequence  of  steady-state  models. 

QUASI -THREE-DIMENSIONAL  MODEL  -  A  combination  of  two-dimensional 
models  used  to  simulate  variations  in  three  dimensions.  (ASCE) 

RECORD  -  A  group  of  words  in  a  binary  file.  It  corresponds  to  a 
line  of  information  in  a  card  image  file.  A  record  is  usually 
terminated  b'  an  end  of  line  mark. 

ROUNDOFF  ERROR  -  The  error  introduced  by  rounding  of  results  from 
individual  arithmetic  operations  because  only  a  finite  number  of 
digits  can  be  retained  after  each  operation. 

RUN  CONTROL  DATA  -  Information  that  is  to  be  read  by  a  program 
and  used  to  specify  the  input  parameters  for  a  program  run,  such 
as  duration  of  simulation. 

SCHEM  AT  I  /.AT  ION  -  Representation  of  a  continuum  by  discrete  ele¬ 
ments,  e.g.,  dividing,  a  real  river  into  reaches  with  constant 
parameters  . 
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SCHEME  (numerical  or  computational)  -  Systematic  program  of  ac¬ 
tion  for  solving  the  governing  equations  of  a  mathematical  model. 
( ASCE) 

SEMI-EMPIRICAL  MODEL  -  Representation  of  a  real  system  by  a 
mathematical  description  based  on  general  physical  laws  but  con¬ 
taining  coefficients  determined  from  experimental  data.  (ASCE) 

SIMULATION  -  Replication  of  the  prototype  using  a  model.  (ASCE) 

SIMULATION  MODEL  -  Mathematical  model  in  which  detailed  values  of 
the  various  parameters  are  computed  both  with  respect  to  space 
and  time. 

SLIP  FLOW  -  A  boundary  condition  specification  in  which  water  is 
allowed  to  flow  along  a  side  boundary  with  a  finite  speed  and  no 
fri  tion  loss.  Also  called  parallel  flow. 

SPIN-UP  -  The  process  by  which  a  model  moves  from  an  unrealistic 
set  of  initial  conditions  (a  COLD START)  to  results  that  represent 
steady  or  quasi- steady  results  that  are  not  strongly  influenced 
by  the  initial  condition. 

STABILITY  (numerical  or  computational)  -  The  ability  of  a  scheme 
to  control  the  propagation  or  growth  of  small  perturbations 
introduced  in  the  calculations.  A  scheme  is  unstable  if  it 
allows  the  growth  of  error,  so  that  it  eventually  obliterates  the 
true  solution.  (ASCE) 

STEADY-STATE  MODEL  -  Model  in  which  the  variables  being  investi¬ 
gated  do  not  change  with  time.  (modified  ASCE) 

STOCHASTIC  MODEL  -  See  Probabilistic  Model.  (ASCE) 

THEORETICAL  MODEL  -  Representation  of  a  real  system  by  a  mathema¬ 
tical  description.  (ASCE) 


THREE-DIMENSIONAL  MODEL  -  Model  defined  on  three  space  coordi¬ 
nates.  (ASCE) 

TRUNCATION  ERROR  -  The  error  introduced  by  replacing  the  differ¬ 
entials  of  a  differential  equation  by  finite  differences  using 
truncated  Taylor  series  expansions. 

TWO-DIMENSIONAL  MODEL  -  Model  defined  on  two  space  coordinates, 
(i.e.,  variables  are  averaged  over  the  third  direction).  (ASCE) 

UNSTEADY-STATE  MODEL  -  Model  in  which  the  variables  being  inves¬ 
tigated  change  with  time.  (modified  ASCE) 

VALIDATION  -  Comparison  ru  model  results  with  a  set  of  prototype 
data  not  used  for  verification.  (ASCE) 
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VERIFICATION  -  The  process  or  state  by  which  a  model  is  adjusted 
and  shown  to  be  a  satisfactory  representation  of  observed  proto¬ 
type  behav  ior. 

WORD  -  A  data  value  in  a  record.  The  word  can  be  a  floating 
point  number,  fixed  point  number,  or  packed  8-character  bytes. 
Word  length — 8,  16,  32,  or  64  bits — depends  on  the  computer 
hardware . 
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20.  ABSTRACT  (Continued). 

profile  in  the  study  reach.  However,  the  increased  head  loss  will  not  violate 
the  0.5  ft-maximum  swellhead  criterion.  Velocities  at  and  downstream  of  the 
constriction  will  increase  approximately  1  fps,  or  at  least  10  percent.  While 
there  are  some  effects  on  navigation  observed  due  to  the  proposed  project,  there 
does  not  appear  to  be  any  significant  increase  in  navigation  difficulty  due  to 
the  runway  extension. 


PREFACE 


The  work  described  herein  was  performed  by  the  US  Army  Engineer  Waterways 
Experiment  Station  (WES)  with  funding  by  the  US  Army  Engineer  District,  Little 
Rock.  The  numerical  models  STUDH  and  RMA-2V  and  their  several  utility  computer 
codes  were  developed  with  funds  from  the  US  Army  Engineer  District,  Portland, 
and  the  Chief  of  Engineers  Improvement  of  Operations  and  Maintenance  Techniques 
research  program. 

Personnel  of  the  WES  Hydraulics  Laboratory  performed  this  study  under 
the  direction  of  Messrs.  H.  B.  Simmons  and  F.  A.  Herrmann,  Jr.,  former  and 
present  Chiefs  of  the  Hydraulics  Laboratory,  and  M.  B.  Boyd,  Chief  of  the 
Hydraulics  Analysis  Division.  Mr.  W.  A.  Thomas  was  project  manager. 

Messrs.  J.  P.  Stewart  and  R.  F.  Athow,  Estuaries  Division,  performed  the 
numerical  model  studies.  Dr.  L.  L.  Daggett  and  Mr.  B.  M.  Comes  performed 
the  ship  simulation  study.  Messrs.  Stewart  and  Daggett  prepared  this  report. 

Commanders  and  Directors  of  WES  during  this  study  and  the  preparation 
and  publication  of  this  report  were  COL  Tilford  C.  Creel,  CE,  and  COL  Robert  C. 
Lee,  CE.  Technical  Director  was  Mr.  F.  R.  Brown. 
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CONVERSION  FACTORS,  NON-SI  TO  SI  (METRIC) 
UNITS  OF  MEASUREMENT 


US  customary  units  of 
metric  (SI)  units  as 
Mu l t i p ly 

cubic  feet  per  second 
feet 

feet  per  second 

miles  (US  statute) 

pounds-seconds  per 
square  foot 

miles  per  hour 


measurement  used  in  this  report 
follows : 

_ ^ _ 

0.02831685 

0.3048 

0.3048 

1.60934 

4.8824 

1.609344 
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can  be  converted  to 

To  Oh  t  a  i  n 

cubic  metres  per  second 
metres 

metres  per  second 
ki lometres 

k i 1 ograms-seconds  per 
square  metre 

kilometres  per  hour 
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IMPACT  OF  PROPOSED  RUNWAY  EXTENSION  AT  LITTLE  ROCK 
MUNICIPAL  AIRPORT  ON  WATER-SURFACE  ELEVATIONS 
AND  NAVIGATION  CONDITIONS  IN  ARKANSAS  RIVER 

PART  I :  INTRODUCTION 
Background 

1.  On  27  September  1983,  the  Little  Rock  Municipal  Airport  Commission 
made  application  for  a  Department  of  the  Army  permit  to  place  fill  material 
and  bank  stabilization  stone  on  the  left  bank  of  Fourche  Creek  at  mile  1.7* 
and  on  the  right  bank  of  the  Arkansas  River  at  mile  161.3  in  connection  with 
the  construction  of  the  Adams  Field  Runway  4R-22L,  Pulaski  County,  Arkansas 
(Figure  1).  The  runway  would  be  placed  on  fill  material  varying  in  height 
from  approximately  258.0  ft  NGVD  on  the  south  end  to  259.75  ft  NGVD  on  the 
north  end. 


Purpose  of  Study 


2.  Personnel  of  the  US  Army  Engineer  Waterways  Experiment  Station  (WES) 
visited  the  US  Army  Engineer  District,  Little  Rock  (SWL) ,  and  photographed 
significant  features  of  the  study  area.  Hydraulic  and  sediment  data  were  ob¬ 
tained  to  develop  and  verify  the  numerical  models. 

3.  The  purpose  of  this  study  was  to  determine  whether  or  not  the  pro¬ 
posed  runway  will  satisfy  the  established  criteria  for  maximum  head  loss  re¬ 
sulting  from  construction  along  the  Arkansas  River.  The  maximum  allowable 
swellhead  criterion  for  any  new  construction  is  0.5  ft.  An  additional  objec¬ 
tive  was  to  predict  changes  in  navigation  characteristics  resulting  from  con¬ 
struction  of  the  new  runway. 


Approach 

4.  The  solution  recommended  to  SWL  was  to  design  a  numerical  model  of 
the  study  area  using  the  TABS-2  system.  Recently  developed  in  the  WES  Hydrau¬ 
lics  Laboratory,  the  TABS-2  offers  a  unique  approach  to  solving  complex  water 


*  A  table  of  factors  for  converting  non-SI  units  of  measurement  to  SI  (metric) 
units  is  presented  on  page  3. 
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resource  problems.  It  is  a  modular  system  composed  of  many  distinct  computer 
programs  linked  together  by  pre-  and  postprocessors.  Each  of  the  major  com¬ 
puter  programs  solves  a  particular  type  of  problem — hydrodynamics,  water  qual¬ 
ity,  or  sediment  transport.  If  a  new  program  is  needed  for  a  particular 
application  or  if  new,  state-of-the-art  programs  become  available,  the  modular 
construction  of  TABS-2  allows  these  new  programs  to  be  easily  incorporated  in¬ 
to  the  system.  Thus  the  modeler  is  assured  of  using  the  best  available  tools 
to  solve  the  problem. 

5.  The  two  numerical  models  used  in  the  head  loss  portion  of  the  study 
were  "A  Two-Dimensional  Finite  Element  Program  for  Problems  in  Horizontal  Free 
Surface  Hydromechanics"  (RMA-2V)  and  "Sediment  Transport  in  Unsteady,  Two- 
Dimensional  Flows  Horizontal  Plane"  (STUDH).  Both  programs  employ  the  finite 
element  method  to  solve  the  governing  equations.  A  brief  description  of  RMA-2V 
and  STUDH  appears  in  Appendices  B  and  C,  respectively.  The  ship  hydrodynamics 
model  used  to  predict  changes  in  navigation  characteristics  was  developed  by 
Hydronautics,  Inc.,  and  incorporated  into  the  WES  ship/tow  simulator  facility. 
Appendix  D  describes  this  model. 

6.  The  proposed  study  plan  consisted  of  seven  steps: 

a.  Develop  a  finite  element  grid  with  a  downstream  boundary  at  the 
L-440  Bridge  and  an  upstream  boundary  at  the  M-P  Railroad  bridge. 

b.  Use  the  computer  program  (RMA-2V,  to  calculate  flow  patterns  and 
water-surface  elevations  for  base  conditions  and  also  for  the 
plan  condition  with  the  proposed  runway.  This  fixed-bed  numeri¬ 
cal  model  would  be  calibrated  for  base  conditions  using  SWL's 
water-surface  profile  for  the  Standard  Project  Flood  (SPF)  of 
625,000  cfs,  and  verified  to  the  profile  of  the  Navigation 
Design  Flood  (NDF)  of  310,000  cfs. 

c.  Use  the  flow  field  for  the  SPF  computed  in  b  as  input  to 
(STUDH).  This  model  will  predict  the  new  riverbed  elevations 
resulting  from  the  SPF. 

d.  Rerun  the  hydrodynamic  model  using  the  updated  bed  elevations 
to  determine  water-surface  elevations  during  the  SPF  under  base 
conditions. 

e.  Repeat  steps  c  and  d  for  the  plan  condition— i.e. ,  with  the 
proposed  runway  in  the  grid--and  compare  the  water-sur face 
elevations  with  those  for  the  base  conditions. 

f.  Run  the  hydrodynamic  code  for  the  NDF  under  base  and  plan 
cond i t ions . 

g.  Use  the  results  of  f  to  run  the  WES  ship  simulation  model  and 
compare  navigation  characteristics  under  base  and  plan  condi- 
t ions . 
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PART  II:  THE  HEAD  LOSS  STUDY  (Q  =  625,000  cfs) 

The  Hydrodynamic  Model 

7.  Data  requirements  for  the  hydrodynamic  model  include: 

a.  The  computational  grid. 

b.  Roughness  coefficients. 

£.  Turbulent  exchange  coefficients. 

d.  Boundary  conditions. 

e.  Initial  water-surface  elevation. 

8.  The  computational  grid  used  by  RMA-2V  and  STUDH  is  created  by  a  pre¬ 
processor  code,  GFGEN.  In  addition  to  a  title  card  and  run  control  data,  input 
to  GFGEN  consists  of  an  element  connection  table  that  identifies  the  nodes 
defining  each  element  and  a  list  of  x-  and  y-coordinates  and  bed  elevations 
for  every  corner  node  in  the  grid.  The  program  then  computes  coordinates  and 
bed  elevations  for  the  midside  nodes,  computes  slopes  for  all  boundary  nodes, 
generates  plots  of  the  grid,  and  writes  the  geometry  file  used  by  RMA-2V  and 
STUDH . 

9.  For  this  study,  an  automatic  grid  generator  was  used  to  create  the 
element  connection  table  and  nodal  x-  and  y-coordinates  for  input  to  GFGEN. 
Input  to  the  grid  generator  consisted  of  sufficient  coordinate  locations  for 
each  row  and  column  to  define  the  geometry  of  the  study  area.  Rows  were 
aligned  along  contour  lines  and  columns,  along  pile  dikes.  The  program  then 
created  the  element  connection  table  and  corner  node  coordinates.  Elevation 
data  were  obtained  from  1978  sediment  range  surveys  that  were  transferred  to 
the  aerial  mosaic  and  contoured.  A  plot  of  the  grid  was  overlaid  on  the  mosaic 
and  elevations  were  determined  at  each  corner  node.  The  final  grid  for  the 
base  test  contained  316  elements  and  1,009  nodes  (Figure  2).  For  the  plan 
test,  the  elements  defining  the  runway  were  removed  from  the  grid  (Figure  3). 
Initial  bathymetry  is  shown  in  Figure  A. 

10.  Manning's  n  values  and  the  turbulent  exchange  coefficients  were 
input  by  element  type.  The  computational  grid  was  partitioned  into  three  re¬ 
gions  as  shown  in  Figure  5.  The  overbank  areas  with  thick  grass,  trees,  and 
debris  were  assigned  an  n-valuo  of  0.060  and  a  turbulent  exchange  coefficient 
of  100  Ib-sec/ft".  The  areas  between  pile,  dikes  and  along  steep  elevation 
gradients  were  given  an  n-value  of  0.15  and  a  turbulent  exchange  coefficient 
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of  75.0  lb-sec/ft^.  The  channel  elements  were  assigned  an  n-value  of  0.020 

2 

and  a  turbulent  exchange  coefficient  of  50.0  lb-sec/ft  .  The  n-values  were 
obtained  from  1-1)  backwater  runs  provided  by  SWL.  They  were  adjusted  somewhat 
during  the  calibration  process  and  are  in  agreement  with  values  recommended  in 
Chow's  Open  Channel  Flow.  The  turbulent  exchange  coefficients  were  adopted 
from  previous  WES  model  studies  using  RMA-2V. 

11.  Boundary  condition  types  for  the  hydrodynamic  model  consisted  of 
velocity  specifications  at  the  upstream  boundary  and  water-surface  elevations 
at  the  downstream  boundary  as  shown  in  Figure  6.  Land  boundaries  were  given  a 
slip  (parallel)  flow  specification  and  nodes  along  the  1-440  embankment  were 
given  a  zero  flow  specification.  For  the  SPF  discharge  of  625,000  cfs,  a  chan¬ 
nel  velocity  of  11.8  fps  was  prescribed  along  the  upstream  end  of  the  grid 

and  a  tailwater  of  248.5  ft  NGVD  was  specified  at  the  downstream  end.  For  the 
navigation  design  flood,  the  upstream  channel  velocity  was  8.3  fps  and  the 
tailwater  elevation  was  240.5  ft  NGVD.  Nonchannel  velocity  specifications 
were  lowered  in  proportion  to  the  depth.  The  velocities  selected  agreed 
fairly  well  with  previous  studies  and  yielded  the  desired  discharge. 

12.  SWL  provided  water-surface  profiles  for  the  two  design  flows, 

310,000  cfs  and  625,000  cfs.  Since  the  higher  flow  was  the  one  of  most  con¬ 
cern,  RMA-2V  was  calibrated  to  that  flow.  The  lower  discharge  was  used  for 
verification  purposes.  The  two  parameters  for  calibration  were  Manning's  n 
and  the  tailwater  elevation.  Referring  to  Figure  5,  we  reduced  the  nonchannel 
n-values  from  the  initial  estimates  of  0.10  and  0.06  to  0.06  and  0.035,  re¬ 
spectively.  The  channel  roughness  was  not  changed.  Referring  to  Figure  6, 
the  tailwater  at  the  downstream  boundary  of  the  grid  (mile  159.8)  was  lowered 
so  the  computed  water-surface  elevations  tied  in  to  SWT's  curve  at  mile  160.1. 
Results  of  the  625, 000-c Is  calibration  are  shown  in  Fig, ure  7.  Only  the  tail- 
water  and  upstream  velocities  were  changed  for  the  110,000-cls  verification 
run.  The  resulting,  profile  is  shown  in  Figure  8. 

The  Sediment  Transport  Model 

1  j.  The  primary  objective  of  this  study  was  to  predict  the  impact  of  the 
runway  extension  on  t he  water-surface  profile  upstream  ot  the  project  for  a 
design  llood  of  623,000  cfs.  To  accurately  predict  the  water-surface  eleva¬ 
tions,  however,  it  was  first  necessary  to  predict  what  tin-  bed  configuration 
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would  be  during  such  a  flood.  To  do  this,  the  sediment  transport  model,  STUDH, 
was  run  for  both  base  and  plan  conditions. 

14.  In  addition  to  the  hydrodynamic  results  computed  by  RMA-2V,  the  in¬ 
put  requirements  for  the  sediment  transport  model  include  grain  sizes,  initial 
sediment  concentration  throughout  the  grid,  and  inflowing  sediment  concentra¬ 
tions  at  the  upstream  boundary. 

15.  Grain-size  information  was  obtained  from  the  "East  Belt  Freeway 
Arkansas  River  Bridge:  Preliminary  Report"  (Carver  and  Garver  1977).  This 
report  showed  an  average  grain  size  of  0.1/  mm  in  the  south  overbank,  0.14  mm 
in  the  north  overbank,  and  0.27  mm  in  the  main  channel  and  stone  dike  areas. 
These  values  were  measured  at  the  bridge  site.  Boring  data  included  in  the 
dike  design  blueprints  showed  that  typical  sediments  were  poorly  graded  sand 
with  some  gravel.  Based  on  these  data,  an  average  grain  size  of  0.27  mm  was 
selected  for  the  sediment  transport  model. 

16.  Initial  sediment  concentrations  and  boundary  condition  concentra¬ 
tions  were  both  obtained  from  Project  Design  Memorandum  No.  5-3  (USAED,  Little 
Rock,  1960).  The  rating  curve  used  is  shown  in  Figure  9.  This  source,  rather 
than  more  recent  measurements,  is  expected  to  produce  the  most  likely  concen¬ 
trations  when  extrapolated  to  625,000-cfs  flow. 

17.  The  magnitude  of  bed  change  computed  by  STUDH  depends  upon  the  dura¬ 
tion  of  the  simulation.  Since  there  was  not  a  design  hydrograph  for  the  SPF, 
SWL  used  the  1957  flood  to  determine  the  time  between  bank-full  flow  and  the 
peak.  This  turned  out  to  be  228  hr.  The  resulting  bathymetry  for  base  and 
plan  conditions  is  shown  in  Figures  10-13. 

Results 

18.  The  new  bathymetry  was  then  input  to  the  hydrodynamic  model  to  com¬ 
pute  water-surface  elevations.  Figures  14-17  show  current  patterns  for  the 
base  and  plan  conditions.  In  the  base  test,  approximately  12  percent  of  the 
flow  passed  over  Gates  Island  at  the  site  of  the  proposed  runway.  The  plan 
condition  diverted  this  water  into  the  main  channel,  increasing  the  velocities 
by  1  fps.  The  resulting  jet  lowered  the  water-surface  elevations  downstream 
of  the  structure  for  nearly  2  miles.  Upstream  of  the  runway,  water-surface 
elevations  were  raised  about  0.1  ft.  Figure  18  shows  the  predicted  impact  of 
the  runway  extension  on  the  water-surface  profile  of  the  design  flood. 
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PART  III:  THE  NAVIGATION  STUDY 

The  Navigation  Model 

19.  In  1983,  tests  were  conducted  on  a  typical  15-barge  tow  operating 
on  the  Upper  Mississippi  River  to  determine  the  effects  of  a  reduced  dredging 
policy.  That  study  included  making  a  preliminary  estimate  of  the  hydrodynamic 
coefficients  of  a  15-barge  tow  and  a  6-barge  tow.  Then  a  full  set  of  towing 
tank  tests  was  performed  to  determine  the  deepwater  hydrodynamic  coefficients, 
the  shallow-water  adjustments  to  these  coefficients,  the  bank  effects,  and  the 
effects  of  dikes  and  irregular  bottoms  (e.g.,  large  sand  waves).  It  was 
found  that  the  estimation  of  the  deepwater  effects  for  the  tow  were  reason¬ 
ably  accurate;  however,  there  were  not  sufficient  data  on  which  to  base  the 
estimates  of  the  shallow-water  and  bank  effects.  Data  were  available  for 
deep-draft  vessels,  principally  tankers,  but  the  behavior  of  shallow-draft 
tows  was  found  to  be  significantly  different.  The  effects  of  dikes  and 
irregular  bottoms  were  not  significant  enough  to  warrant  detailed  modeling. 

Those  simulated  tows  were  extensively  tested  by  river  pilots  and  given  high 
ratings  on  the  realism  of  their  performance  in  both  deep  pool  and  restricted 
channel  conditions. 

20.  For  the  purposes  of  the  Little  Rock  Airport  Study,  a  6-barge  tow 
with  the  configuration  of  3  wide  and  2  long  was  used.  The  overall  tow  length 
was  530  ft  and  the  beam  was  105  ft.  This  is  the  assumed  makeup  of  a  typical 
large  tow  on  the  McLellan-Kerr  Waterway  because  it  readily  fits  into  the 

600-  by  110-ft  locks  on  the  waterway.  The  towboat  characteristics  are  those  of 
the  3,000-  to  3,500-HP  class.  Since  some  differences  were  found  between  the 
estimated  and  the  tested  15-barge  tow  used  for  the  Upper  Mississippi  study,  the 
estimated  6-barge  tow  was  developed  from  the  tested  15-barge  tow  by  adjusting 
coefficients  based  on  the  procedures  developed  by  Hydronaut ics ,  Inc.,  for 
estimating  the  coefficients.  This  involved  adjusting  the  coefficients  ac¬ 
cording  to  dimension  or  mass  ratios.  The  same  shallow-water  and  bank  effects 
were  used  as  determined  in  the  15-barge  tow  tests.  For  the  Little  Rock  simu¬ 
lation,  the  tow  operated  in  relatively  deep  water  with  depth-to-draf t  ratios 
of  3  or  greater  and  at  large  distances  from  the  banks,  at  least  two  beam  widths. 
Therefore  the  shallow-water  and  bank  effects  are  assumed  to  be  small. 

21.  Results  of  standard  maneuvering  tests  for  th  ■  est  invited  6-barge  tow 
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tow  used  in  this  study  and  the  tested  15-barge  tow  are  shown  in  Table  1.  As 
can  be  seen,  the  6-barge  tow  travels  at  a  faster  rate  than  the  heavier  15-barge 
tow  and  stops  and  turns  quicker  than  the  larger  tow.  In  addition,  prototype 
tests  have  been  conducted  for  a  similar  size,  powered  tow  but  with  a  different 
configuration.  These  tests  provide  a  comparison  of  the  tow  speed/power  rela¬ 
tion.  These  tows  were  3,330-  to  2,670-hp  towboats  and  the  tow  was  1,160  ft 
long  and  54  ft  wide.  This  is  about  equivalent  in  carrying  capacity  to  the 
3  by  2  tow  but  is  a  more  slender  configuration  and,  therefore,  less  resistant. 


Table  1 

Comparison  of  Tow  Maneuvering  Characteristics 


Estimated  6- 
Barge  Tow 


Measured  15- 
Barge  Tow 


30-deg  turning  circle 
Advance 
Transfer 

Full  speed  ahead 

Crash  stop 

Stopping  time 
Distance 

Crash  stop  with  rudder 
Stopping  time 
Distance 


1,779  ft 
885  ft 

9.79  mph 


4.10  sec 
1,032  ft 

4.10  sec 
1,030  ft 


3,720  ft 
1,781  ft 

7.68  mph 


14.0  sec 
2,509  ft 


14.2  sec 
2,577  ft 


The  full  ahead  speed  for  these  tows  is  11.6  and  11.9  mph,  respectively.  The 
6-barge  tow  used  for  this  study  falls  between  the  15-barge  tow  and  the  more 
slender  equivalent  6-barge  tow  as  expected.  During  the  test  runs,  the  tow  was 
operated  at  90  percent  of  full  throttle  which  is  equivalent  to  2,700  lip. 

22.  The  condition  selected  to  test  the  impacts  on  navigation  due  to  the 
constriction  of  the  waterway  with  the  proposed  airport  extension  was  the  high¬ 
est  flow  at  which  navigation  is  permitted.  This  flow  is  310,000  cfs  and  over¬ 
tops  the  overbank  areas  on  both  sides  of  the  waterway.  Hie  airport  expansion 
would  then  create  a  blockage  to  the  flow  over  the  Gates  Island  on  the  right- 
hand  descending  bank  and  redirect  the  flow  into  the  navigation  channel.  At 
the  highest  flow  under  which  navigation  is  permitted,  the  potential  for  cross¬ 
currents  will  be  the  highest  anti  therefore  the  impacts  on  navigation  will  be 
the  greatest. 
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23.  The  approacli  taken  in  this  study  was  to  compare  the  navigation  con¬ 

ditions  for  the  existing,  or  base,  conditions  with  the  conditions  created  with 
the  airport  extension  in  place,  i.e.,  the  plan  condition.  These  conditions 
were  compared  for  both  downbound  and  tipbound  transits.  Since  the  airport  ex¬ 
tension  plan  does  not  protrude  into  the  navigation  channel  per  se,  the  naviga¬ 
tion  channel  dimensions  do  not  change.  The  only  change  then  is  in  the  current 

magnitude  and  direction  in  the  vicinity  of  the  extension.  These  current  pat¬ 
terns  were  determined  using  the  RMA-2V  model  using  a  flow  of  310,000  cfs  and 
the  appropriate  tailwater  elevation  from  SWL's  water-surface  profiles. 

24.  The  general  flow  patterns  for  the  base  and  plan  are  shown  in  Fig¬ 
ures  19  and  20,  respectively.  The  expanded  view  of  the  currents  in  the  vicin¬ 
ity  of  the  airport  extension  given  in  Figures  21  and  22  shows  in  more  detail 
the  changes  in  the  flow  due  to  the  runway.  Changes  in  the  direction  of  flow 
are  concentrated  on  the  right-hand  descending  side  of  the  channel  and  do  not 
appear  to  extend  into  the  navigation  portion  of  the  channel  which  is  on  the 
left-hand  side  of  the  channel.  There  is  an  increase  of  1  to  1.5  f ps  in  the 
magnitude  of  the  currents  in  the  navigation  channel. 

25.  For  purposes  of  the  navigation  model,  30  cross  sections  of  veloci¬ 
ties  and  depths  were  extracted  from  the  RMA-2  model  results  within  the  naviga¬ 

tion  channel.  For  this  purpose,  the  navigation  channel  was  taken  as  either  the 
bank  line,  the  9-ft  water  depth  contour,  or  the  end  of  the  dikes.  The  actual 
marked  navigation  channel  lies  within  this  definition.  The  currents  extracted 
from  the  RMA-2  results  for  the  base  and  plan  are  shown  in  Figures  23  and  24. 
Again,  the  magnified  views  given  in  Figures  25  and  26  show  that  the  impact  on 
the  currents  in  the  navigation  channel  is  minor  and  consists  of  increased 
velocity  magnitudes  in  the  contracted  portion  of  the  channel  and  some  limited 
change  in  direction  immediately  below  the  airport  extension.  It  should  be 
noted  that  the  channel  cross  sections  are  concentrated  in  the  area  of  the 
planned  construction  so  that  these  effects  are  properly  modeled  for  the  naviga¬ 
tion  tests. 

26.  Figures  27  and  28  show  the  modeled  currents  and  the  navigation 
channel  boundaries  for  the  base  and  plan  conditions,  respectively.  The  dike 
fields  and  the  airport  extension  are  displayed  for  reference  purposes.  The 
navigation  buoys  are  also  included  in  the  t  igures  although  they  are  difficult 
to  dist  inguish  amour,  the  current  vectors. 
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27.  In  order  to  provide  direct  comparison  of  the  impacts  of  the  airport 
extension,  the  navigation  transits  were  made  under  the  control  of  an  autopilot 
which  is  designed  to  correct  for  errors  or  changes  in  heading  and  distance 
off  course  and  to  minimize  the  rate  of  rotation.  An  advance  look-ahead  fea¬ 
ture  is  included  that  is  a  function  of  the  magnitude  of  the  heading  change  in 
the  desired  course.  Using  the  autopilot  provides  a  consistent  level  of  con¬ 
trol  of  the  tow.  Any  significant  impacts  would  be  expected  to  be  evident  in 
the  track  lines  or  in  the  difficulty  of  the  navigation,  e.g.,  increased  rudder 
activity  and/or  reduced  rudder  reserve.  The  autopilot  track  lines  to  be  fol¬ 
lowed,  shown  in  Figures  29  and  30,  are  identical  for  base  and  plan.  The  track 
lines  in  the  base  condition  (Figure  29)  are  for  a  downbound  transit  and  the 
track  lines  in  the  plan  condition  (Figure  30)  are  for  an  upbound  transit. 

Re sul t  s 

28.  The  transit  paths  for  the  downbound  transits  of  the  tow  are  shown 
in  Figures  31  and  32  for  the  base  and  plan  conditions,  respectively.  It  can 
be  seen  by  overlaying  these  two  plots  that  the  path  taken  by  the  tow  is  not 
significantly  affected  by  the  runway.  In  both  cases,  the  tow  has  some  diffi¬ 
culty  in  changing  course  just  downstream  from  the  location  of  the  proposed 
airport  extension.  The  upbound  transit  track  lines  are  shown  in  Figures  33 
and  34  for  the  base  and  plan  conditions,  respectively.  Notice  that  the  up- 
bound  tow  has  more  control  in  making  the  turns  as  the  changes  in  the  course 
line  are  very  distinct.  The  tow  is  also  going  much  slower  as  noted  by  the 
dense  line  with  small  incremental  steps  of  the  tow  being  plotted  at  constant 
time  intervals.  Again,  it  is  difficult  to  detect  any  significant  differences 
in  the  path  followed  by  the  upbound  tow.  The  track  line  is  more  dense  and 
hence  the  tow  is  going  slower  just  downstream  of  the  extension  in  the  plan 
condition.  Also,  both  upstream  transits  terminated  when  the  maximum  run  time 
was  exceeded.  The  transit  through  the  plan  condition  is  much  shorter  than 
the  base  condition  transit.  This  is  an  indication  of  the  increase  in  water 
velocity  in  the  plan  condition. 

29.  In  order  to  understand  the  navigation  activities  required  to  make 
these  transits,  plots  of  the  rudder  and  engine  activities  and  the  tow  speed 
and  distance  off-track  were  generated.  The  plots  for  the  downbound  tow  for 
the  base  and  plan  condition  are  shown  in  Figures  35  and  36,  respectively;  the 
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upbound  transit  activities  are  shown  in  Figures  37  and  38.  For  reference  pur¬ 
poses,  the  navigation  mile  locations  are  indicated  on  the  abscissa  with  tri¬ 
angles  beginning  with  navigation  mile  118.0  and  proceeding  downstream  from 
left  to  right.  Again,  it  is  noted  that  the  downbound  transits  are  proceeding 
at  a  much  higher  speed,  approximately  12  to  15  mph,  while  the  upbound  transits 
vary  between  1  and  5  mph.  Also,  the  downbound  transits  require  more  extensive 
rudder  activity  and  have  larger  deviations  from  the  desired  track  line.  How¬ 
ever,  it  is  difficult  to  distinguish  any  significant  differences  between  the 
base  and  plan  for  transits  in  the  same  direction. 

30.  To  assist  in  this  analysis,  comparison  plots  of  the  clearance  to 
the  edge  of  the  navigation  channel  and  of  the  rudder  settings  and  speed  were 
developed.  Figure  39  shows  that  the  downbound  transits  for  the  base  and  plan 
conditions  maintained  nearly  the  same  clearances  on  the  port  and  starboard 
sides.  Differences  appear  to  be  20  ft  or  less.  The  upbound  transits,  shown 
in  Figure  40,  may  have  experienced  larger  differences  between  the  base  and 
plan  conditions  with  the  area  between  navigation  miles  115.0  and  115.5  finding 
the  tow  about  30  ft  closer  to  the  starboard  channel  edge  with  the  airport 
extension  in  place.  However,  since  there  is  over  1,000  ft  of  clearance  on  the 
port  side  there  is  adequate  channel  available  for  the  tow  to  move  away  from 
the  starboard  side. 

31.  The  amount  of  rudder  activity  required  for  both  the  upbound  and 
downbound  tows  is  nearly  the  same,  as  is  shown  in  Figures  4]  and  42.  In  all 
cases,  there  is  at  least  10  deg  of  rudder  reserve  remaining  for  emergency 
maneuvers  and  except  for  a  few  cases  rudder  settings  are  less  than  15  deg. 

The  differences  in  forward  speed  are  evident  and  the  increased  current  effects 
on  the  speed  are  quite  distinct  between  navigation  miles  114.0  and  115.0. 
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PART  IV:  CONCLUSIONS 

32.  The  proposed  runway  will  have  a  noticeable  effect  on  the  water- 
surface  profile  in  the  study  reach.  However,  the  increased  head  loss  will  not 
violate  the  0.5-ft  maximum  swellhead  criterion.  Velocities  at  and  downstream 
of  the  constriction  will  increase  approximately  1  fps,  or  about  10  percent. 

33.  While  there  are  some  effects  on  navigation  observed  due  to  the  pro¬ 
posed  project,  there  does  not  appear  to  be  any  significant  increase  in  naviga¬ 
tion  difficulty  due  to  the  airport  extension  evident  in  the  autopilot  runs. 
There  is  a  distinct  decrease  in  forward  speed  for  upbound  tows  due  to  the 
increased  velocities.  It  is  evident  from  the  "full  speed  ahead"  values  in 
Table  1  that  for  tows  of  this  size,  the  power  of  the  towboat  cannot  be  any 
smaller  than  that  used  for  the  model  tow.  This  is  true  for  the  existing  con¬ 
ditions  as  well  as  the  proposed  runway  extension,  however. 

34.  The  best  data  available  within  time  and  budgetary  constraints  have 
been  used  and  state-of-the-art  solution  techniques  have  been  applied  to  pre¬ 
dict  the  impact  of  the  proposed  runway  on  water-surface  profiles  and  naviga¬ 
tion  characteristics.  ResuLts  show  that  the  impact  will  not  be  significant. 
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Figure  6.  Boundary  condition  specification 
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Figure  8.  Verification  of  RMA-2V 


Figure  11.  Magnification  of  postflood  bathymetry  for  base  test,  after  228  hr  of  sediment  transport 


Figure  13.  Magnification  of  postflood  bathymetry  for  plan  test,  after  228  hr  of  sediment  transport 


Figure  15.  Magnification  of  postflood  current  patterns  for  base  test,  after  228  hr  of  sediment  transfer 
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Figure  22.  Magnification  of  flow  pattern  for  navigation  design  flood  plan  test 
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26.  Magnification  of  flow  pattern  in  navigation  channel,  plan  test 
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APPENDIX  A:  FINITE  ELEMENT  MODELING 

1.  The  two  numerical  models  used  in  this  effort  employ  the  finite  ele¬ 
ment  method  to  solve  the  governing  equations.  To  help  those  who  are  unfamiliar 
with  the  method  to  better  understand  this  report,  a  brief  description  of  the 
method  is  given  here.  For  a  more  thorough  treatment,  see  Zienkiewicz  (1971) 

or  Desai  (1979)  . 

2.  The  finite  element  method  approximates  a  solution  to  equations  by 
dividing  the  area  of  interest  into  smaller  subareas,  which  are  called  elements. 
The  dependent  variables  (e.g.,  water-surface  elevations  and  sediment  con¬ 
centrations)  are  approximated  over  each  element  by  continuous  functions  which 
interpolate  in  terms  of  unknown  point  (node)  values  of  the  variables.  An 
error,  defined  as  the  deviation  of  the  approximation  solution  from  the  cor¬ 
rect  solution,  is  minimized.  Then,  when  boundary  conditions  are  imposed,  a 
set  of  solvable  simultaneous  equations  is  created.  The  solution  is  smooth 

and  continous  over  the  area  of  interest. 

3.  In  one-dimensional  problems,  elements  are  line  segments.  In  two- 
dimensional  problems,  the  elements  are  polygons,  usually  either  triangles  or 
quadrilaterals.  Nodes  are  located  on  the  edges  of  elements  and  occasionally 
inside  the  elements.  The  interpolating  functions  may  be  linear  or  higher 
order  polynomials.  Figure  A1  illustrates  a  quadrilateral  element  with  eight 
nodes  and  a  linear  solution  surface. 

4.  Most  water  resource  applications  of  the  finite  element  method  use 
the  Galerkin  method  of  weighted  residuals  to  minimize  error.  In  this  method 
the  residual,  the  total  error  between  the  approximate  and  correct  solutions, 
is  weighted  by  a  function  that  is  identical  with  the  interpolating  function 
and  then  minimized.  Minimization  results  in  a  set  of  simultaneous  equations 
in  terms  of  nodal  values  of  the  dependent  variable  (e.g.,  water-surface  ele¬ 
vations  or  sediment  concentration).  Time-dependent  problems  can  have  the 
time  portion  solved  by  the  finite  element  methods,  but  it  is  generally  more 
efficient  to  express  derivatives  with  respect  to  time  in  finite  difference 
form. 
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APPENDIX  B:  THE  HYDRODYNAMIC  MODEL,  RMA-2V 

1.  The  generalized  computer  program  RMA-2  solves  the  depth-integrated 
equations  of  fluid  mass  and  momentum  conservation  in  two  horizontal  direc¬ 
tions.  The  form  of  the  solved  equations  is 


Du  ,  Du  Du  Dh  ^3o  £xx  D2u  £xy  D2u 

Dt  Dx  Dy  s  Dx  s  Dx  p  _  2  p  ,  2 

Dx  Dy 


2  2  1/2  CV 

-2vcj  sin  $  +  ^T-  (u  +  v  )  -  — —  cos  Y  =  0 

c2h  h 

.  .  Da  e  .2  e  .2 

Dv  ,  Dv  Dv  ,  Dh  ,  o  yx  D  v  yy  D  v  ,  „ 

+  u  —  +  v_—  +  g—  +g  - —  -  — L - —r  -  — -  +  2wu  sin  (J> 

Dt  Dx  Dy  6  Dy  6  Dy  p  ^2  p  ^2 


,  ,  1/2  CV 

+  (u  +  v  )  -  — j;-  sin  Y  =  0 

C2h  h 


Dh  ,  D  ,  , ,  ,  D 

+  Dx  (uh)  +  (vh> 


where 


u  =  depth-integrated  horizontal  flow  velocity  in  the  x-direction 
t  =  time 

x  =  distance  in  the  x-direction  (longitudinal) 

v  =  depth-integrated  horizontal  flow  velocity  in  the  y-direction 

y  =  distance  in  the  y-direction  (lateral) 

g  =  acceleration  due  to  gravity 

h  =  water  depth 

a  =  elevation  of  the  bottom 
o 

e  =  normal  turbulent  exchange  coefficient  in  the  x-direction 
xx 

p  =  fluid  density 

e  =  tangential  turbulent  exchange  coefficient  in  the  x-direction 
w  =  angular  rate  of  earth’s  rotation 
<t>  =  latitude 

C  =  Chezy  roughness  coefficient 

f,  =  coefficient  relating  wind  speed  to  stress  exerted  on  the  fluid 
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V  =  wind  velocity 

a 

T  =  angle  between  wind  direction  and  x-axis 
e  =  tangential  turbulent  exchange  coefficient  in  the  y-direction 
!_  =  normal  turbulent  exchange  coefficient  in  the  y-direction 

yy 

2.  The  Chezy  roughness  formulation  of  the  original  code  was  modified 

in  the  input  portion  so  that  Manning's  n  roughness  coefficients  may  be  speci¬ 
fied  from  input  Manning's  n  values  and  initial  water  depth. 

3.  Equations  Bl,  B2,  and  B3  are  solved  by  the  finite  element  method 
using  C.alerkin  weighted  residuals.  The  elements  may  be  either  quadrilaterals 
or  triangles  and  may  have  curved  (parabolic)  sides.  The  shape  functions  are 
quadratic  for  flow  and  linear  for  depth.  Integration  in  space  is  performed 
by  Gaussian  integration.  Derivatives  in  time  are  replaced  by  a  nonlinear 
finite  difference  approximation.  Variables  are  assumed  to  vary  over  each 
time  interval  in  the  form 

f(t)  =  f(o)  +  at  +  btC  t  <  t  <  t1  (B4) 

which  is  differentiated  with  respect  to  time,  and  cast  in  finite  difference 
form.  Letters  a  ,  b  ,  and  c  are  constants.  It  has  been  found  by  experi¬ 
ment  that  the  best  value  for  c  is  1.5  (Norton  and  King  1977). 

4.  The  solution  is  fully  implicit  and  the  set  of  simultaneous  equations 
is  solved  by  Newton-Raphson  iteration.  The  computer  code  executes  the  solution 
by  means  of  a  front-type  solver  that  assembles  a  portion  of  the  matrix  and 
solves  it  before  assembling  the  next  portion  of  the  matrix.  The  front  sol¬ 
ver's  efficiency  is  largely  independent  of  bandwidth  and  thus  does  not  re¬ 
quire  as  much  care  in  formation  of  the  computational  mesh  as  do  traditional 
solvers. 

5.  The  code  RMA-2V  is  based  on  the  earlier  version  RMA-2  (Norton  and 
King  1977)  but  differs  from  it  in  several  ways.  First,  it  is  formulated  in 
terms  of  velocity  (v)  instead  of  unit  discharge  (vh) ,  which  improves  some 
aspects  of  the  code's  behavior;  it  permits  drying  and  wetting  of  areas  with¬ 
in  the  grid;  and  it  permits  specification  of  turbulent  exchange  coefficients 
in  directions  other  than  along  the  x-  and  y-axis. 
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APPENDIX  C:  THE  SEDIMENT  TRANSPORT  MODEL,  STUDH 


1-  The  generalized  computer  program  STUDH  solves  the  depth-integrated 
convection-dispersion  equation  in  two  horizontal  dimensions  for  a  single 
sediment  constituent.  The  form  of  the  solved  equation  is 


—  + 
3t 


u 


3C 

3x 


3C 

v  3y 


a_ 

3x 


D  f 

x  3x 


3_ 

3y 


y  3y 


a^C  + 


(Cl) 


where 

C  =  concentration  of  sediment 
u  =  depth-integrated  velocity  in  x-direction 
v  =  depth-integrated  velocity  in  y-direction 
D^  =  dispersion  coefficient  in  x-direction 
0^  =  dispersion  coefficient  in  y-direction 

=  coefficient  of  concentration  dependent  source/sink  term 
=  coefficient  of  source/sink  term 

STUDH  is  related  to  the  generalized  computer  program  SEDIMENT  II  (Ariathurai, 
MacArthur,  and  Krone  1977)  developed  at  the  University  of  California,  Davis, 
under  the  direction  of  R.  B.  Krone.  STUDH  is  the  product  of  joint  efforts  of 
WES  personnel  (under  the  direction  of  W.  A.  Thomas)  and  R.  Ariathurai,  now 
a  member  of  Resource  Management  Associates. 

2.  The  source/sink  terms  in  Equation  Cl  are  computed  in  routines  that 
treat  the  interaction  of  the  flow  and  the  bed.  Separate  sections  of  the  code 
handle  computations  for  clay  bed  and  sand  bed  problems.  In  the  tests  de¬ 
scribed  here,  only  sand  beds  were  considered.  The  source/sink  terms  were 
evaluated  by  first  computing  a  potential  sand  transport  capacity  for  the 
specified  flow  conditions,  comparing  that  capacity  with  the  amount  of  sand 
actually  being  transported,  and  then  eroding  from  or  depositing  to  the  bed 

at  a  rate  that  would  approach  the  equilibrium  value  after  sufficient  elapsed 
time . 

3.  The  potential  sand  transport  capacity  in  these  tests  was  computed  by 
the  method  of  Ackers  and  White  (1973),  which  uses  a  transport  power  (work 
rate)  approach.  It  has  been  shown  to  provide  superior  results  for  transport 
under  steady-flow  conditions  (White,  Milli,  and  Crabbe  1975)  and  for  combined 
waves  and  currents  (Swart  1976) .  WES  flume  tests  have  shown  that  the  concept 
is  valid  for  transport  by  estuarine  currents. 
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4.  The  total  load  transport  function  of  Ackers  and  White  is  based  upon 
a  dimensionless  grain  size 

V  =  D  [£iV“Ul  (c2) 


where 


D  =  sediment  particle  diameter 
g  =  acceleration  due  to  gravity 
s  =  specific  gravity  of  the  sediment 
v  =  kinematic  viscosity  of  the  fluid 
and  a  sediment  mobility  parameter 


Tn  T.(l-n) 

pg  D(s  -  1) 


where 

t  =  total  boundary  shear  stress 

n  =  a  coefficient  expressing  the  relative  importance  of  bed-load  and 
suspended-load  transport,  given  in  Equation  C5 

t'  =  boundary  surface  shear  stress 

p  =  water  density 

The  surface  shear  stress  is  that  part  of  the  total  shear  stress  which  is  due 
to  the  rough  surface  of  the  bed  only,  i.e.,  not  including  that  part  due  to 
bed  forms  and  geometry.  It  therefore  corresponds  to  that  shear  stress  which 
a  plane  bed  would  exert  on  the  flow. 

5.  The  total  sediment  transport  is  expressed  as  a  potential  concentra- 


G  =  k 
P 


where  U  is  the  average  flow  velocity,  h  is  the  water  depth,  and  k  ,  m  , 

and  A  are  coefficients  as  defined  below.  For  1  <  I)  <  60 

,;r 


n  =  1.00  -  0.56  log  1) 
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0.23 

A  =  —  -  +  0.14  (C6) 

[d 

yj  gr 

log  C  =  2.86  log  D^r  -  (log  D^r)2  -  3.53  (C7) 

m  =  +1.34  (C8) 

gr 


For  D  >60 
gr 


n  =  0.00 

(C9) 

A  =  0.17 

(CIO) 

k  =  0.025 

(Cl  1) 

m  =  1.5 


(  C 1 2  ) 


6.  Bed  shear  stresses  for  combined  waves  and  currents  are  calculated  by 
STUDH  using  the  equation 
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for  surface  shear  stress  (plane  beds)  and 
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shear  stress,  whert' 
shear  stress  coefficient  for  waves 
shear  stress  coefficient  for  currents 
average  flow  velocity 

maximum  wave  orbital  velocity  near  the  bed 
density  of  water 
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Equations  C13  and  C14  are  based  on  the  work  of  Jonsson  (1966),  and  Bijker  and 
Swart  (Swart  1976).  Development  of  the  equations  is  given  by  McAnally  and 
Thomas  (1981) . 

7.  Using  Equations  C13  and  C14  for  shear  stresses  in  the  Ackers-White 
equations  (Equations  C2-C12)  results  in  a  potential  sediment  concentration, 

6^  .  This  value  is  the  depth-averaged  concentration  of  sediment  that  will 
occur  if  an  equilibrium  transport  rate  is  reached  with  a  nonlimited  supply  of 
sediment.  The  rate  of  sediment  deposition  (or  erosion)  is  then  computed  as 


R  =  -E_ 


G  -  C 


(Cl  5) 


where 

C  =  present  sediment  concentration 

t  =  time  constant 
c 

For  deposition,  the  time  constant  is 


=  larger  of 


(C16) 


1L-J 


and  for  erosion  it  is 


t  =  larger  of 


(C 1 7 ) 


where 


\t  =  computational  time-step 
I  -  response  time  coefficient  for  deposition 
h  -  water  depth 


I  XAMi'U.  i’ROBI.FM 


C4 
C  7  0 


04/85 


=  sediment  settling  velocity 

C,  =  response  time  coefficient  for  erosion 
Le 

U  =  average  current  speed 

8.  Equation  Cl  is  solved  by  the  finite  element  method  using  Galerkin 
weighted  residuals.  Like  RMA-2V,  which  uses  the  same  general  solution  tech¬ 
nique,  elements  are  quadrilateral  and  may  have  parabolic  sides.  Shape  func¬ 
tions  are  quadratic.  Integration  in  space  is  Gaussian.  Time-stepping  is 
performed  by  a  Crank-Nicholson  approach  with  a  weighting  factor  (theta)  of 
0.66.  The  solution  is  fully  implicit  and  front-type  solver  is  used  similar 
to  that  in  RMA-2V. 
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APPENDIX  D:  THE  NAVIGATION  MODEL 


1-  'Hie  effects  of  the  proposed  runway  extension  on  navigation  opera¬ 
tions  through  the  study  reach  were  studied  using  a  ship  hydrodynamics  model 
developed  for  use  in  modei ing  shallow-draft  pushtows.  The  model  was  developed 
by  Hydronautics ,  Inc.,  and  is  incorporated  into  the  WES  ship/tow  simulator  fa¬ 
cility.  This  model  is  a  mathematical  model  for  the  maneuvering  of  a  river 
tow  and  consists  of  the  coupled  differential  equations  of  motion  in  three 
degrees  of  freedom  (surge,  yaw,  and  sway)  in  the  X,Y  plane  and  the  complete 
set  of  hydrodynamic  coefficients  and  external  forces  which  are  required  in 
order  to  numerically  integrate  these  equations.  There  are  also  auxiliary 
equations  that  describe  the  response  of  the  steering  and  propulsion  system 
to  command  signals. 

2.  A  complete  set  of  three  coupled  differential  equations  with  all  of 
the  necessary  terms  to  s  mulate  normal  maneuvers  of  surface  ships  is  presented 
in  Goodman  et  al.  (1976)  and  a  description  of  the  application  of  these 
equations  to  tile  towboat  simulator  is  given  by  Miller  (1979).  These  equations 
have  been  used  successfully  for  a  number  of  years  to  calculate  the  maneuver 
trajectories  for  a  wide  range  of  surface  ship  types  in  deep  and  shallow 
water.  These  equations  have  been  modified  to  account  for  maneuvering  charac¬ 
teristics  that  are  unique  to  river  tows.  A  right-hand  orthogonal  system  of 
moving  axes,  fixed  in  the  body,  with  its  origin  normal 1 y  located  at  the 
center  of  mass  of  the  body  is  used  for  reference.  The  positive  direction 

of  the  axes,  angles,  linear  velocity  components,  angular  velocity  components, 
forces,  and  moments  are  given  in  Figure  Dl.  The  numerical  values  for  the 
hydrodynamic  coefficients  used  in  the  equations  are  written  in  terms  of  the 
complete  barge  flotilla/towboat  configuration  and  are  nond imensional .  Thus 
the  values  of  the  coefficients  can  be  applied  to  geometrically  similar  tows. 

The  values  of  the  coefficients  embrace  the  interaction  effects  between  the 
rudder  and  hull,  propeller  and  hull,  and  propeller  and  rudder  as  determined 
from  towing  tank  model  tests  of  the  complete  configuration. 

3.  An  important  consideration  in  the  maneuvering  of  a  river  tow  is  the 
effect  of  current  which  can  vary  significantly  along  the  length  of  the  tow.  As 
a  result,  it  is  necessary  to  introduce  the  effect  of  the  current  velocity  into 
the  mathemat i ca 1  model.  The  approach  adopted  was  to  define  the  hydrodynamic 
terms  in  the  equations  based  on  the  relative  velocities  and  yaw  rate  between 
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the  hull  and  the  fluid  rather  than  the  inertial  velocities  and  yaw  rate.  The 
relative  velocities  and  relative  yaw  rate  can  be  calculated  by  the  vector 
addition  of  the  inertial  velocity  and  inertial  yaw  rate  and  the  current  velo¬ 
cities  and  the  current  yaw  rate.  In  the  numerical  integration,  the  procedure 
is  to  define  a  matrix  of  current  speeds  and  directions  at  points  on  the  X,Y 
plane.  Based  on  the  location  of  the  bow,  midship,  and  stern  of  the  tow,  an 
interpolation  in  the  current  speed  and  direction  matrix  is  carried  out  to 
obtain  the  current  speed  and  direction  at  the  bow,  midship,  and  stern.  Then 
a  mean  longitudinal  and  lateral  current  velocity  in  the  body  axis  system  is 
computed  as  the  average  of  the  values  at  the  bow,  midship,  and  stern.  The 
variation  of  the  lateral  velocity  along  the  tow  is  accounted  for  by  the  ap¬ 
parent  current  yaw  rate  defined  by  the  difference  in  the  lateral  velocities 
at  the  bow  and  stern  divided  by  the  tow  length.  This  accounts  for  variations. 

4.  Towboat  propulsion  systems  differ  from  those  in  ships.  Tows  perform 
backing  operations  frequently,  and  because  of  this,  they  have  two  sets  of  rud¬ 
ders.  Thus  terms  are  included  to  account  for  the  forces  and  moments  created 
by  the  flanking  and  steering  rudders  which  can  be  operated  independently.  In 
addition,  many  tows  are  propelled  with  twin  propellers  that  are  independently 
powered.  Terms  have  been  included  for  twin  propeller  forces  and  moments  which 
may  operate  at  different  rpm's  and  different  directions  of  rotation. 

5.  In  realistic  maneuvers,  river  tows  operate  both  ahead  and  astern  and 
in  some  cases  at  large  drift  angles.  In  order  to  properly  represent  the  hydro- 
dynamic  forces  and  moments  which  act  in  such  conditions,  different  sets  of 
hydrodynamic  coefficients  are  used  depending  on  the  relative  drift  angle. 

Thus  the  hydrodynamic  coefficients  vary  depending  on  whether  the  motion  is 
ahead  or  astern  and  whether  the  drift  angle  is  near  90  or  270  deg. 

6.  In  addition,  tows  often  operate  in  shallow  water  and  near  banks.  In 
shallow-water  operations,  the  tow  maneuvering  characteristics  change  signifi¬ 
cantly — cypically  becoming  more  stable  and  thus  less  maneuverable.  Adjust¬ 
ments  are  made  to  the  hydrodynamic  coefficients  to  reflect  those  changes  and, 
like  the  determination  of  the  deepwater  hydrodynamic,  coefficients,  are  de¬ 
veloped  from  model  tests  at  various  depth-to-draf t  ratios.  Bank  forces  are  a 
function  of  the  distance  from  and  the  orientation  to  the  banks.  Computations 
for  the  bank  forces  and  moments  are  included  in  the  hydrodynamic  equations. 

7.  The  equations  of  motion  are  solved  stepwise  in  Lime  in  the  computer 
program.  At  each  time-step,  the  current  velocity,  depth  of  water,  and  distance 
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from  the  port  and  starboard  bank  are  determined  at  the  bow,  midship,  and  stern 
of  the  tow.  Currents  and  depths  are  entered  to  the  model  as  cross  sections 
with  up  to  30  cross  sections  and  8  points  per  cross  section  being  allowed. 

Port  and  starboard  bank  conditions  are  defined  for  each  cross  section  by  speci¬ 
fying  the  overbank  depth  and  slope  of  the  bank. 
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FINITE  ELEMENT  NETWORK  GENERATION 


PART  I:  INTRODUCTION 


1.  Numerical  modeling  requires  that  a  set  of  computation 
points  be  established  in  space,  assigned  a  number,  assigned  a  bed 
elevation,  and  referenced  to  each  other  in  space.  Because  the 
finite  element  method  allows  randomly  placed  points,  as  opposed 
to  the  regularly  spaced  grids  in  finite  difference  schemes, 
developing  the  spatial  locations  and  reference  table  can  be  a 
sizable  task.  The  process  is  called  network  generation  in  this 
document.  Both  manual  and  automated  methods  have  been  used  with 
most  emphasis  given  to  the  automated  method  in  recent  years. 

2.  At  the  present  level  of  development,  automatic  mesh 
generation  in  TABS-2  is  a  four-step  process.  The  first  three 
steps  apply  to  initial  development.  The  fourth  step  applies  only 
to  the  modification  of  existing  meshes.  The  steps  are: 

a.  Model  boundaries  are  established  and  regions  having 
similar  properties  are  located  (i.e.,  channels, 
tloodplains,  dike  fields,  dikes,  etc.) 

b^.  The  boundaries  are  digitized,  input  data  describing 
the  mesh  density  are  provided,  and  the  mesh  is 
processed  through  program  AUTOMSH  to  construct  a 
computational  network. 

c.  The  output  from  AUTOMSH  is  processed  through  GFGEN 
where  final  mesh  layout  and  geometry  are  developed 
for  input  to  programs  RMA-2V,  STUDH,  and  RMA-A. 

d.  Modifications  to  the  mesh  are  made,  if  needed, 
using  either  the  refinement  capability  in  GFGEN, 
the  interactive  mesh  editor  EDGRG,  or  manual 
revision  using  a  text  editor. 

3.  The  three  computer  programs,  AUTOMSH,  GFGEN,  and  EDGRG, 
are  presented  and  their  use  is  described  in  this  appendix. 
Programs  CON F EG,  which  transforms  coordinate  systems,  and 
FNDNODE,  which  reads  a  GFGEN  output  file  and  finds  the  five 
closest  nodes  to  a  given  set  of  coordinates,  are  described  here 
also. 


Elements  and  Nodes 


A.  The  process  of  mesh  generation  starts  with  a  map  of  the 
study  area.  This  map  should  show  elevation  and  roughness  infor¬ 
mation.  The  objective  is  to  locate  computation  points  in  space 
so  that  straight  lines  connecting  adjacent  computation  points 
follow  the  bed  elevation,  roughness  types,  or  sediment  character- 
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istics  between  those  points.  Computation  points  should  also  be 
located  at  sharp  changes  in  the  water-  surface  elevation  or  the 
velocity  field  such  as  convergence  zones.  When  computation 
points  are  not  located  in  sufficient  detail  at  hydraulic,  sedi¬ 
ment,  and  salinity  controls,  the  accuracy  of  the  computation  is 
compromised.  Wetting  and  drying  of  shallows  is  accomplished  by 
setting  entire  elements  wet  or  dry.*  Thus  element  layout  becomes 
important  for  properly  identifying  wet  and  dry  areas  of  the  mesh. 

5.  The  computation  points  are  called  nodes,  and  nodes  are 
connected  to  each  other  by  lines  that  create  either  triangular  or 
quadrilateral  elements.  The  TABS-2  programs  allow  both  element 
shapes  in  the  same  mesh,  but  experience  has  shown  it  very  desira¬ 
ble  to  be  systematic. 

6.  Each  node  and  element  must  be  numbered.  An  example  of 
the  e 1  erne n t -nod  a l  point  scheme  is  shown  in  Figure  Dl.  Although 
this  mesh  is  regular,  there  is  no  requirement  that  it  be  so.  The 
point  of  interest  is  the  element  numbered  65  which  has  eight 
nodes  around  it.  Those  at  the  corners  are  called  corner  nodes. 
Those  midway  between  corners  are  called  midside  nodes.  The  nodes 
are  also  common  to  adjacent  elements  and  that  must  be  specified 
in  a  nodal  connection  table.  Figure  D  2  shows  the  element  nodal 
point  connection  table  for  the  vicinity  of  element  65.  Each  node 
has  two  numbers  --  one  relative  to  the  element  and  one  absolute  . 
In  either  case,  the  numbering  scheme  starts  at  a  corner  node. 
Relative  position  //I  is  the  lower  right  corner  of  element  number 
1,  and  numbering  proceeds  counterclock-wise  around  the  element. 
The  position  table  on  Figure  D2  illustrates  that  principle. 

X  and  Y  Coordinates 


7.  Each  corner  node  needs  location  (x,y)  coordinates  and  a 
bed  elevation  (z)  to  be  specified.  The  mesh  generator  AUTOMSH 
provides  the  (  x  ,  y  )  coordinate  for  corner  nodes  and  GFGEN  calcu¬ 
lates  midside  locations  as  well  as  allows  the  corner  node  z 
coordinates  to  be  input. 

8.  AUTOMSH  uses  the  (x,y)  coordinates  of  the  boundary.  It 
allows  node  density  to  be  specified  and  then  calculates  the  (x,y) 
locations  of  each  corner  node,  both  in  the  interior  and  along  the 
boundary;  calculates  the  node  numbers  and  element  numbers;  and 
develops  the  element-nodal  point  connection  table.  The  result  is 
a  file  can  be  ready  directly  by  GFGEN,  which  is  the  next  step  in 
mesh  generation.  Details  for  using  AUTOMSH  are  shown  in  Addendum 
D-  1  . 


Actually,  complete  drying  does  not  occur.  When  the  water 
depth  falls  below  some  small,  preset  value,  that  area  of  the 
mesh  is  removed  from  the  calculations  even  though  some  water 
remains  there. 
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Figure  01.  Nodes  and  elements 
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PART  II:  NETWORK  CREATION 


9.  Creation  of  the  proper  finite  element  network  is  a 
fundamental  aspect  of  finite  element  modeling.  Although 
averaging  or  differencing  is  not  involved,  the  finite  element 
shape  functions  distribute  calculated  values  over  the  plement. 
Therefore  nodal  points  should  be  carefully  located  to  capture 
changes  of  depth  and  energy  gradient  so  that  the  average  over  the 
element  contains  these  extremes.  Automatic  mesh  generators  (the 
mesh  is  the  set  of  lines,  elements,  and  nodes  in  the  FE  network) 
can  locate  the  (x,y)  coordinates  of  nodes  so  they  best  fit  the 
continuous  surface  requirement  of  the  finite  element  shape  func¬ 
tions;  but  the  automatic  mesh  generators  do  not  consider  the  z  - 
coordinate  in  that  procedure  (the  bed  elevation)  nor  do  they  take 
sharp  changes  in  gradients  info  account.  Consequently,  the  judg¬ 
ment  of  the  user  is  essential  to  ensure  that  these  factors  are 
incorporated  into  the  network.  Good  judgment  is  also  needed  to 
locate  the  upstream  and  downstream  boundaries  of  the  network. 
Boundaries  that  are  too  close  will  contaminate  results  in  the 
area  of  interest.  Boundaries  at  locations  where  flow  is  strongly 
nonuniform  may  cause  erratic  results. 


External  boundaries 


10.  The  external  boundary  of  a  network  refers  to  the  lines 
of  nodes  that  have  elements  along  only  one  side  of  them  as  op¬ 
posed  to  Internal  lines  of  nodes.  Examples  of  external  bounda¬ 
ries  are  the  ends  and  sides  of  the  network  and  islands,  piers,  or 
other  internal  features  that  are  not  overtopped  by  the  flow. 


11.  The  significance  of  external  boundaries  stems  from  the 
2-D  nature  of  the  computations.  In  1-1)  computations,  flow  always 
travels  parallel  to  the  sides  of  the  numerical  network.  That  is 
not  the  case  in  2-D  computations;  and  consequently,  the  calcu¬ 
lated  velocity  vectors  can  intersect  the  sidewall  of  the  network 
rather  than  be  parallel  to  it,  just  as  they  do  the  end  bounda¬ 
ries.  The  result  is  a  leak.  It  is  necessary  to  identify  all 
external  boundaries  using  input  data  so  RMA-2V  can  avoid  leak 
problems . 


12.  An  external  boundary  line  can  be  either  a  straight 
line,  a  sequence  of  straight-line  segments  having  sharp  corners 
where  one  element  joins  another,  or  a  smooth  ,  quadratic  curve. 

For  the  second  case,  the  velocity  components  at  each  node  must 
usually  be  zero.  When  a  smooth  (straight-line  or  quadratic) 
curve  is  prescribed,  RMA-2V  will  calculate  the  boundary  tangent 
at  each  node  and  align  the  velocity  vector  so  that  flow  is  paral¬ 
lel  to  the  boundary  at  that  point.  Consequently,  leaks  are 
avoided  by  the  proper  specification  of  boundary  conditions. 
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Wetting  and  Or  yin;’ 

IT.  Areas  of  the  network  that  become  almost  dry  are 
resolved  by  manipu Latin,  the  individual  elements.  If  any  node  in 
an  element  is  dry,  r '  entire  element  is  removed  from  the 

computations.  This  procedure  produces  two  problems:  an  irregu¬ 

lar  side -boundary  having  sharp  corners  rather  than  the  smooth 
external  boundary  of  the  original  network,  and  numerical  shocks 
each  time  an  element  is  added  or  removed.  In  wet/dry  mode,  the 
program  aligns  the  boundary  velocity  vectors  with  the  irregular 
boundary  to  prevent  leaks  and  to  allow  a  slip-flow  along,  the 
newly  formed  external  boundary.  Both  the  velocity  and  its  time 
derivatives  at  the  present  and  past  iteration  are  thus  recalcu¬ 
lated.  This  special  treatment  of  flow  along  a  boundary  applies 
only  to  partially  dry  meshes.  It  is  not  applicable  along  exter¬ 
nal  boundaries.  By  keeping  elements  small,  numerical  shock  can 
he  minimized  and  by  increasing  the  number  of  iterations  between 
dry-mesh-checks,  stability  can  he  increased. 

14.  The  finite  element  mesh  controls  both  lateral  and 
vertical  boundaries.  The  degree  to  which  it  models  lateral 
boundaries  can  be  observed  by  overlaying  the  mesh  on  a  map  or 
aerial  mosaic.  The  agreement  vitli  vertical  boundaries  is  more 
difficult  to  ascertain.  That  is,  bed  elevations  are  coded  at 
each  corner  node,  and  the  program  constructs  a  bed-plane  in  each 
element.  It  is  important  that  the  elevations  in  that  bed-plane 
model  the  true  elevations  of  the  bed  throughout  the  element.  It 
is  difficult  to  visualize  the  2-dimensional  model  planes,  but  if 
elements  are  aligned  along  cross  sections,  the  PK  bed  can  be 
plotted  on  the  cross  section  to  check  bed  elevations.  Corner 
node  elevations  are  connected  by  straight  lines. 

15.  An  (x,y)  coordinate  can  have  only  one  elevation  (i.e., 
elements  cannot  stand  on  their  edge )  . 

GKGKN 

16.  The  final  step  in  the  initial  development  of  a  mesh  Is 
to  process  the  AUTOMSI!  output  file  with  GKGKN.  It  checks  the 
mesh  for  potential  errors,  merges  all  bed  elevations,  locates  all 
curved  boundary  slopes,  optimizes  element  number  sequence  for 
most  efficient  computations,  and  creates  plot  files  of  the  mesh. 
The  output  from  GKGKN  is  the  finite  element  network  for  the  TABS- 
2  programs.  Instructions  tor  using  GKGKN  are  shown  in  Addendum 
0-2  . 

17.  The  matrix  solvers  used  in  the  TABS-2  system  programs 
do  not  rely  on  a  narrow  bandwidth  for  efficient  computations. 

The  programs  use  frontal  pivotal  elimination  routines  that  re¬ 
quire  a  reduction  in  the  front  width.  The  process  is  called 
reordtring  and  is  performed  by  GKGKN  or  AllTOMSH.  The 
computational  cost  savings  possible  with  effective  reordering 
makes  it  worth  some  additional  effort  to  achieve.  See  the  GKGKN 
User  Instructions  for  further  discussion  of  reordering. 
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Mesh  Editing  and  Modification 

18.  The  interactive  program  F.DGRG  permits  shifting  existing 
elements  and  nodes  around  and/or  adding  new  ones.  This  is  useful 
when  it  is  necessary  to  reuse  an  existing  mesh  or  add  detail  in  a 
new  mesh  where  the  automatic  calculations  are  inadequate. 

Details  for  using  EDGRG  are  shown  in  Addendum  D-3.  The  network 
can  also  be  modified  by  using  a  text  editor  to  change  the  A  U  T  0  M  S  H 
output  file  (GFGEN  input). 

Graphics 


19.  AUTOMSH,  GFGEN,  and  EDGRG  each  have  graphics  capability. 
They  are  explained  along  with  other  details  of  using  those 
programs  in  the  addenda. 

Planned  Improvements 

20.  Because  of  the  importance  of  mesh  generation,  an 
optional  alternate  mesh  generator  is  under  development. 
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ADDENDUM  D- 1  :  USER  INSTRUCTIONS  FOR  PROGRAM  AUTOMSH, 

AUTOMATIC  MESH  GENERATION 


Purpose 


1.  AUTOMSH  is  a  group  of  utility  programs  that  are  used  to 
automatically  create  computational  meshes  for  the  TABS-2  models. 
Given  information  on  the  regions  to  he  covered  by  the  mesh  and 
the  desired  density  of  elements,  it  creates  a  computational 
network,  including  node  locations  and  element  connection  tables. 
Output  from  AUTOMSH  serves  as  input  to  the  geometry  file 
generator,  GFGEN. 


Origin  of  Program 


2.  AUTOMSH  consists  of  four  programs  plus  a  plotter  code-- 
PREMESH,  QMKSH  RF.NUM,  POSTMSH,  AND  QP  LOT  ,  respectively.  QMESH  , 
RENUM,  and  QPLOT  were  obtained  from  Sandia  National  Laboratories, 
Albuquerque,  New  Mexico.  PREMESH  and  POSTMSH  were  written  by 

D.  P.  Bach  of  the  Estuaries  Division,  Hydraulics  Laboratory,  WES. 
RENUM  was  modified  hy  D.  P.  Bach. 

Description 

3.  AUTOMSH  is  a  ba t c h -o r i e n t ed  family  of  codes  that  are 
linked  together  so  an  entire  mesh  can  be  generated  in  a  single 
submission  to  the  computer. 

4.  PREMESH  takes  digitizer  data  along  with  card  image  input 
data  for  run  control  and  writes  an  input  file  for  QMESH  plus  a 
list  of  mid  side  nodes  for  POSTMSH. 

5.  QMESH  is  the  mesh  generator.  It  fills  each  region  with 
elements  and  smooths  out  irregularities. 

6.  RENUM  reorders  node  numbers  to  achieve  a  minimum  uont 
width  for  a  uniform  number  scheme.  A  companion  code,  QPLOT,  reads 
RENUM  output  files  and  plots  sections  of  the  mesh. 

7.  POSTMSH  adds  midside  nodes  and  boundary  curvature  in 
the  form  of  a  slope  which  is  tangent  to  the  boundary  line  at  that 
node,  and  writes  a  file  for  input  to  GFGEN. 

8.  GKGF.N  is  not  part  of  the  AUTOMSH  family.  It  is  the 
finite  element  geometry  file  generator  for  the  TABS-2  system. 
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The  Mesh  Generation  Process 

9.  The  following  procedure  should  he  used: 

a.  I.  ay  a  plastic  overlay  on  a  chart  or  map  of  area 

of  interest.  All  markings  should  he  in  fine  pen  o r 
pencil  to  improve  accuracy  durinj;  digitizing. 

b.  Draw  lines  dividing  the  area  into  REGIONS,  with 
each  REGION  hav  in>;  no  more  than  13  separate  LINES 
ih't  ining  it.  REGIONS  should  he  chosen  based  on 
desired  RM  A- 2  V  element  types  (for  defining 
roughness  and  e  d  d  v  viscosity  c  o  e  t 1  i  c  1  e  n  t  s  )  and  on 
the  amount  of  control  that  is  desired  over  the 
mesh.  Each  REGION  and  the  LINES  separating  t  fie 
different  REGIONS  should  be  numbered. 

c  .  Digitize  the  lines  del  ini  n  g  e  a  c  h  re  g  ion. 

During  digitization,  curved  LINES  should  he  defined 
w i t h  as  line  a  resolution  as  practical. 

d.  Extra  care  should  be  taken  in  digitizing  the  points 
at  the  beginning  and  end  of  each  LINE,  as  accuracy 
is  especially  important  there. 

Figure  D  —  1  —  t  shows  the  Al'TOMSIl  procedure  in  flow  chart  form. 

10.  The  run  control  input  to  P RE MESH  consists  of  card 
images  containing  a  keyword  that  identifies  the  data  that  are  on 
the  rest  of  the  card.  These  cards  may  appear  in  any  order,  with 
the  exception  of  the  end  card.  The  special  keywords  include 
COMMKN,  LINE,  REGION,  SCHEME.,  TOE,  MULT,  and  END.  Instructions 
for  these  card  image  data  are  given  hog, inning  on  page  If-l-IO. 
Input  to  subsequent  programs  is  generated  automatically.  The 
format  tor  digitizer  file  input  (logical  unit  01)  to  PUKMESH  is 
*  i  v  e  n  in  Table  1)  -  I  -  1  . 

11.  Program  QNHSH.  ()MKSH  was  released  in  1974  by  Saudi  a 

Laboratories,  a  prime  Department  of  Energy  contractor.  because 
P  HEMES  11  provides  an  interlace  to  QMKSII,  full  documentation  tor 
OMESII  is  not  presented  here.  The  fJMESIt  input  data  are  described 
in  R .  E  .  Jones  ,  19  7  4  "User's  Manual  for  OMESII,  a  So  1  t  -Organ  i  z  i  ng 

MESH  Generation  Program,"  Sandia  Report  No.  S  I.  A- 7  4 -i  I  2  )  9  ,  Sand  in 
National  Laboratories,  Albuquerque,  N M  .  The  s m o o  t  ii  i  n  methods 

that  DMKSH  employs  are  described  in  K.  E.  Jones,  19  7  4  ,  "OMESII:  A 
Se 1 f -Or  gun i z i ng  Mesh  Generation  Program,"  Sandia  Report  No  .  SLA- 

7  3  -  1  0  0  g  ,  Sandia  National  Laboratories,  Albuquerque,  . 

1  2  .  P  r  o  g  r  i m  R E N  U  M  .  PENPM  requires  no  input  d  i  r  t  e  t  1  v  ;  r  o ■■ 
the  user.  The  program  lias  been  nod  i  I  i  ml  to  u  s  i  the  front- 
minimizing  technique  described  in  Mark  Unit  and  E  .  1.  Li  Ison, 

1  ‘>H  1  ,  "An  Equation  Numbering  Algorithm  based  on  a  "ini  n-  front 
Er  i  ter  i  a,"  Computers  &  Structures,  Vo  1  In,  No  .  I  -  .  ,  ;  ,  •  II  >  -  !  3  *  , 
Peri',  am  on  Press  Ltd.,  (ire  at  Britain. 
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13.  Program  POSTMSH  ,  POSTMSH  requires  no  direct  input  from 
the  user.  The  program  reads  files  that  are  generated  by  PRKMESH 
(mid-side  node  locations)  and  by  KhNUM  (grid  specification  with¬ 
out  mid-side  nodes).  Slopes  at  corner  nodes  are  computed  by  the 
following  formula: 

dy  -3Y |  +  4Y2  -  Y3 


dx,  -3Xj  +  4  X  2  -  X3 

w  it  e  r  e 

dy 

—  =  slope  at  corner  node  1 
d  x 

1 

X |  , Y  j  =  coordinates  of  node  1 

X2’^2  =  coordinates  of  tentative  mid-side  node 
X  3 , Y  3  =  coordinates  of  corner  node  2 

Output 

14.  Output  from  PREMESH  consists  ot  a  QMESH  input  file  on 
logical  unit  5,  a  tentative  list  oi  midside  nodes  on  logical  unit 
85  (2F12.1  format),  and  diagnostics  on  the  standard  printer  file. 


15.  Output  from  POSTMSH  is  a  coded  data  tile  that  is  in  the 
proper  format  to  be  used  by  program  GP'GEN,  the  geometry  file 
generator.  OF  GEN  is  described  in  Addendum  1)  -  3 . 


Example 


1  6  . 

The  following  Listings 

tile 

a  n  d 

the  digitizer  data  file. 

1 o 1  lows 

the  data 

listings  (Figure 

Card 

image  input 

file 

COM  Ml 

N 

YAZOO 

BACKWATER  AREA  - 

L  I  N  K 

1 

-4 

L  1  NE 

3 

-4 

i.  1  ME 

5 

-3 

I.  I  NE 

f> 

-2 

i.  r  NE 

7 

-l) 

1.  1  NE 

X 

-  2 

1. 1  NE 

9 

-8 

show  the  card  image  input  data 
The  mesh  plot ,  out  of  OFTEN, 

D- 1 -2  )  . 
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s 


LINE 

78 

-1 

LINE 

79 

-8 

LINE 

80 

-1 

LINE 

8  1 

-15 

LINE 

82 

-1 

LINE 

83 

-  1 

LINE 

84 

-1 

LI  NE 

85 

-  1 

LINE 

86 

-2 

LINE 

87 

-2 

LINE 

88 

-4 

LINE 

89 

-4 

RECION 

2 

1 

60 

6  1 

62 

REGION 

1 

2 

88 

86 

65 

87 

89 

68 

REGION 

2 

3 

8 

10 

6 

9 

REGION 

1 

4 

5 

1  3 

1  4 

1  5 

16 

3 

REGION 

1 

5 

8  1 

82 

77 

83 

REGION 

1 

6 

72 

77 

78 

79 

8  0 

7  4 

REGION 

2 

7 

23 

22 

25 

16 

REGION 

1 

8 

1  1 

70 

83 

7  1 

73 

28 

REGION 

1 

9 

17 

7  1 

84 

68 

85 

69 

REGION 

2 

10 

14 

32 

33 

34 

35 

REGION 

2 

1  1 

33 

36 

37 

38 

REGION 

2 

1  2 

34 

40 

58 

29 

24 

39 

REGION 

1 

1  3 

43 

73 

74 

75 

76 

REGION 

2 

14 

5 

45 

46 

44 

REGION 

2 

1  5 

46 

47 

48 

49 

50 

5  1 

REGION 

2 

16 

12 

52 

48 

56 

REGION 

2 

1  7 

43 

54 

5  5 

53 

REGION 

1 

18 

28 

53 

57 

49 

52 

59 

REGION 

1 

19 

85 

89 

66 

67 

REGION 

1 

20 

84 

62 

63 

64 

88 

TOL 

10 

.0 

MULT 

1 

.0 

END 

Digitizer 

data 

file 

used 

a  s 

input 

to  PREMESH 

Ya  zoo 

4 

10 

3173 

2654 

32 1250724 100 

1649 

227 

331880718770 

503 

1636 

326  5707  1  3  500 

-5  5  5  5 

5 

1268 

27  3 

1  365 

65 

1369 

57 

-  5  5  5  5 

7 

10  16 

802 

1264 

283 

1  2  6  8 

27  3 

-  5  5  5  5 

1  5 
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Input  Instructions 

17.  The  following  pages  provide  instructions  for  card-image 
run  control  input  to  program  PRKMKSH.  Seven  card  types  are  used 
as  shown  in  the  table  below. 


Card  Type 

Purpose 

Page 

COMMEN 

Provide  run  title. 

D-  1  -  1  1 

LINE 

Define  a  line  bordering  a  region. 

D-  1  -1 2 

REG  ION 

Define  a  region  to  be  filled  with 
e  1  emen  t  s . 

D-l  -1  3 

SCHEME 

Control  the  mesh  smoothing  scheme. 

D-  1  -  1  4 

TOL 

Specify  tolerance  for  inaccurate 
digitizing  of  LINK  endpoints. 

in 

I 

l 

a 

MULT 

Specify  multiplier  to  convert 
digitizer  coordinates. 

D-l  -16 

END 

Signals  end  of  input  and  controls 
type  and  quantity  of  output. 

1)-)  -1  7 
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COMMEN  card 


Col umns  Format*  _ Descript 


1-6  A  The  keyword 

11-80  A  Run  title 


The  run  title  on  the  COMMEN  card  is  passed  through 
AUTOMSH  programs  and  is  placed  at  the  top  of  the 
file. 

*  A  =  Alphanumeric 

F  =  Floating  point  numerical 
I  =  Integer  numerical 


ion 


COMMEN 


all  of  t  h 
GFGEN  input 
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NETWORK 


04/85 


LINE  card 


Required 


Columns 


Format 


Description 


1  -4  A 

11-15  I 

16-25  F 


26-35 


F 


36-40 


1 


The  keyword  LINE 

The  identifier  of  the  LINE 
( 1 -999) . 

If  positive,  arc  length  between 
nodes  in  mesh  coordinates 
(needs  finely  defined  LINE) 

If  negative,  indicates  the  numbe 
of  panels  this  line  is  to  he 
broken  into. 

Default  =  +100.0 

Factor  to  decrease  nodal  spacing 
with  a  tighter  curve  radius  in 
mesh  units/degrees  (arc  length 
=  previous  length  - 
factor*degrees).  Ignored  if 
the  boundary  flag  (column  40) 
is  zero. 

Default  =  0.0. 

Boundary  or  curved  side  conditio 

0  =  Not  boundary  or  curved  LINE. 

1  =  Fit  slopes  to  this  boundary. 

Default  =  0 


The  use  of  a  negative  value  in  columns  16-25  seems  to  be  the 
easiest  way  to  set  up  the  mesh.  The  factor  to  decrease  the  nodal 
spacing  can  be  used  to  cluster  nodes  around  corners.  Using  a 
negative  value  in  columns  16-15,  a  LINE  can  be  defined  by  minimum 
of  two  points--start  and  finish.  Be  sure  to  take  care  in 
digitizing  start  and  finish  points. 
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KEG  LON  card 


Required 


Co  1 umn  s 

Format 

Description 

1  -6 

A 

The  keyword  REGION 

7-10 

I 

The  element  type*  for  this 
REGION. 

11-15 

l 

The  identifying  number  for  this 
REG  ION  (1 -999) 

16-80 

1315 

A  list  of  LINES  defining  this 
REGION,  in  connecting 
consecutive  order. 

A  maximum  of  thirteen  (13)  LINKS  defining  each  R  KG  ION  is 
allowed.  The  line  order  may  be  clockwise  or  counterclockwise. 
Best  results  are  obtained  if  an  even  number  of  element  nodes  are 
produced  along  the  RKGlON's  boundaries. 


Element  types  are  used  by  RMA-2V  to  define  eddy  viscosity 
and  r  o  u  g  n  e  s  s  coefficients. 
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SCHEME  card 


Opt i ona  1 


Columns  Format 


Descript  ion 


1-6  A 

11-15  I 


16-80  A 


The  keyword  SCHEME 

The  identifying  number  of  the 

region  to  which  this  card  applies 
A  zero  indicates  that  this  card 
applies  to  all  regions. 

The  series  of  letters  specifying  a 
QMESH  smoothing  scheme. 

Default  =  MSP(RS(D)S)  P 
(no  scheme  card) 


This  card  controls  the  most  powerful  part  of  QMESH --its  wide 
variety  of  smoothing  algorithms.  The  selected  default  (which  is 
a  little  different  from  QMESH's  default)  was  chosen  as  the  most 
stable  for  the  TABS  type  of  mesh.  However,  this  default  is 
probably  not  the  best  choice  for  all  possible  regions,  so  the 
user  is  free  to  experiment  with  different  smoothing  SCHEMES. 

A  discussion  of  the  various  scheme  commands  is  given 
beginning  on  page  D  —  1  —  1 8  . 
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TO  I,  card 


Optional 


Columns  Format  _ Description 


1-3  A  The  keyword  TOL 

11-15  I  Distance  for  P  R  E  M  E  S  H  to  look  for 

points  while  forming  REGION 
boundaries,  in  mesh  coordinates 
Default  (TOL  card  omitted)  =  10.0 


This  card  specifies  a  TOLerance  for  "sloppy"  and  inaccurate 
digitization.  A  value  greater  than  100  feet  should  never  be 
used.  If  a  setting  of  greater  than  100  feet  appears  to  be 
needed,  the  digitizer  input  file  should  be  edited  instead,  as  th 
input  data  is  incorrect,  not  inaccurate.  Once  again,  extreme 
care  should  be  taken  during  digitization. 
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MULT  card 


Optional 


Co  L  umns  Format  _ Description _ 

1-4  A  The  keyword  MULT 

11-15  F  A  value  by  which  the  trans¬ 

formation  mesh  coordinates 
are  to  be  scaled. 

Default  (MULT  card  omitted)  =  1000.0 

This  card  specifies  the  setting  of  the  decimal  point  for  the 
grid  coordinate  specification  on  record  types  4,  6,  and  8  on  the 

digitizer  input  file.*  A  value  less  than  1  allows  fractional  grid 
coordinates  to  be  used,  while  a  value  greater  than  1  will  permit 
the  use  of  grid  coordinates  greater  than  999,999.0  units.  Also, 
to  ensure  proper  mapping  from  digitizer  to  mesh  coordinates,  make 
sure  that  each  x-coord  inate  and  each  y-coordinate  on  card  types 
4,  6,  and  8  are  different. 


See  Appendix  E . 
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E N  D  card 


Required 


Columns  Format  _ Description _ 

1-3  A  The  keyword  END 

13  l  IDEBUG  -  QMESH  print  control 

Default  =  3. 

5  =  Echo  print  input  cards  and  fatal 
error  messages 

4  =  Same  as  5  plus  printer  plots  of 
perimeter  of  each  region  and 
notice  of  successful 
restructuring,  deletions,  etc. 

3  =  Same  as  4  plus  a  list  of  nodes 
generated  by  each  QMESH  line, 
each  line  making  up  the  perimeter 
and  a  statistical  analysis  of  the 
final  mesh  on  each  region  (3  is 
default  used  if  no  END  card  used) 

2  =  Same  as  3  plus  a  more  complete  trace 
of  restructuring  and  deletions  and, 
in  case  of  error,  a  dump  of  the 
input  table. 

1  =  Same  as  2  plus  a  complete  trace  of 

restructuring  card  deletion 

This  card  signals  the  end  of  PREMESH's  run  control  input  and 
tells  QMESH  how  much  output  is  desired. 
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18.  The  following  paragraphs  describe  the  various  scheme 
commands  and  were  copied  from  R.  E.  Jones,  1  9  7  A  ,  "User's  Manual 
for  QMESH,  A  Se 1 f - Or g a n i z i ng  Mesh  Generation  Program,"  Sandia 
Report  No.  SLA-74-0239,  Sandia  National  Labs,  Albuquerque,  NM. 


"QMESH  normally  develops  an  initial  mesh  for  each  region 
without  direction  from  the  user.  (The  exception  is  the  M  command 
discussed  below.)  The  SCHEME  card  directs  the  processing  after 
the  initial  mesh  is  set  up,  including,  the  order  and  types  of  mesh 
modifications  to  be  attempted,  parameter  adjustments,  production 
of  plots,  and  special  printing. 

"If  no  SCHEME  cards  are  supplied  by  the  user,  QMESH  will  use 
a  default  scheme,  which  at  the  time  of  this  writing  is 
SP(RS(D)S)P .  The  user  may  supplant  this  default  scheme  by 
supplying  a  SCHEME  card  with  REGION  number  left  blank  or  set  to 
zero.  Then  that  stated  SCHEME  will  be  used  for  all  regions  not 
having  specific  SCHEME  cards.  A  SCHEME  card  with  a  specific 
REGION  number  supplied  (in  columns  11  to  15)  will  take 
precedence  for  that  region  over  QMESH's  default  as  well  as  over 
any  SCHEME  cards  with  zero  or  blank  REGION  numbers.  Thus,  a 
typical  mode  of  operation  might  be  for  the  user  to  supply  a 
fairly  simple  zero  region  number  SCHEME  to  apply  to  most  regions, 
and  then  supply  more  elaborate  specific  SCHEMES  for  the  few 
difficult  regions.  A  simple  SCHEME  which  would  suffice  for  many 
relatively  simple  regions  would  be  simply  P,  which  would  cause 
the  initial  mesh  to  be  plotted.  Alternatively,  SP,  to  smooth  the 
initial  mesh  and  plot  the  result  might  be  used.  If  no  plotting 
is  desired,  simply  S  might  do,  or  the  SCHEME  could  even  be  blank. 
See  the  end  of  this  (fourth)  section  for  further  examples. 

"The  SCHEME  codes  (commands)  are  grouped  in  the  following 
pages  into  related  categories.  The  most  important  SCHEME 
commands  for  most  users  will  be  P,  S,  R,  1),  and  the  left  and 
right  parenthesis  which  are  used  to  define  loops.  The  categories 
are: 

Initial  mesh  defining  commands 
Smoothing  commands 

Restructuring  and  related  commands 

Plot  command  s 

Print  command  s 

Loop  and  branching  commands 

Initial  Me  s  h  Defining  Commands 

"M  (Mesh)  If  this  letter  appears  as  the  first  letter  of  the 
scheme,  QMESH  will  determine  for  itself  a  reasonable  shape  and 
orientation  for  the  initial  mesh,  based  on  relative  location  of 
natu.nl  corners  of  the  region.  Otherwise,  the  first  LINE  or  SIDE 
given  on  the  REGION  card  will  become  the  base  of  the  (logically 
rectangular)  initial  mesh. 
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"0  (Originate)  This  command  causes  the  initial  mesh  to  be 
regenerated.  All  previous  structural  or  smoothing  operations  are 
thus  lost.  The  purpose  of  this  command  is  to  allow  several 
different  trial  schemes  to  be  experimented  with  on  one  SCHEME 
card.  (See  examples  of  schemes.) 

Smoothing  Commands 

" S  (Smooth)  S  causes  the  appropriate  routine  to  be  called, 
provided  some  activity  has  occurred  since  the  last  S  was 
encountered.  That  activity  could  be  any  successful  restructure 
or  element  deletion  (R,  W,  D),  a  necklace  installation  (N),  a 
smoothing  parameter  change  (H,  I,  J,  A),  a  change  in  the 
smoothing  algorithm  being  used  (1,2,.  .  .),  or  a  reorignation  of 

the  initial  mesh  (0).  If  no  such  activity  has  occurred  since  the 
last  S  was  encountered,  this  smoothing  operation  is  skipped  (as 
it  evidently  would  be  a  waste  of  time). 

"1,2,.  .  .,6  These  commands  control  the  choice  of  smoothing 

algorithm  to  be  invoked  by  subsequent  S  commands.  The  choice  of 
smoothing  algorithms  may  be  changed  as  often  as  desired  in  a 
scheme.  The  choices  are: 


1  ' Equipotent I al '  smoothing  if  the  mesh  is  not 
structurally  modified  from  the  initial  mesh; 
otherwise  'area  pull  and  Laplacian'  smoothing 

2  'Area  pull  and  Laplacian’  smoothing 

3  'Centroid  inverse  area  push  and  Laplacian'  smoothing 

4  'Centroid  area  puli'  smoothing 

5  Laplacian  smoothing 

6  Length-weighted  Laplacian  smoothing. 

"I  or  +  I  (Iterations)  This  command  causes  the  maximum 
allowable  number  of  Iterations  (i.e.,  sweeps  ot  the  mesh)  for 
smoothing  processors  to  be  increased  by  half  (30%).  Initially 
the  maximum  number  of  iterations  is  set  to  M  ^  +  M ,  where  the 

initial  rectangular  mesh  is  of  size  M  ^  intervals  by  M.^  intervals. 

"-I  This  command  causes  the  maximum  allowable  number  of 
iterations  to  be  used  by  smoothing  processors  to  he  decreased  by 
one  third  (33.3%).  Thus,  the  series  +1  -I  or  -I  +  I  would  leave 

the  maximum  number  of  iterations  essentially  unchanged. 

"  J  or  +.1  This  command  causes  the  node  movement  tolerance 
for  convergence  ot  smoothing  to  be  increased  by  a  factor  equal  to 
the  cube  root  of  2. 
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"-J  Causes  the  node  movement  tolerance  for  convergence  of 
smoothing  to  be  decreased  by  a  factor  equal  to  the  cube  root  of 
2.  (This  causes  smoother  meshes  to  be  generated  but  costs  more 
execution  time.) 

“ H  or  +H  Causes  ,  the  relaxation  factor  which  is  usually 

1.0,  to  be  increased  by  0.25. 

"-H  Causes  to  be  decreased  by  0.25. 

"A  or  +A  (Alpha)  Causes  ,  which  is  the  weight  for  the  area 
pull  portion  of  the  "area  pull  and  Laplaci an"  smoother,  to  be 
increased  by  0.1.  The  initial  value  of  is  0.7.  As  increases 

toward  1.0,  the  areas  of  the  elements  tend  to  become  more  nearly 
e  qua  1  . 

"-A  Causes  to  be  decreased  by  0.1. 

Restructuring  and  Related  Commands 

"R  (Restructure)  The  restructure  processor  attempts  to 
restructure  the  mesh  in  as  many  places  as  feasible  to  improve  the 
shapes  of  elements.  A  significant  amount  of  the  execution  time 
of  the  R  command  is  in  its  initial  phase,  after  which  one  or  more 
restructures  are  performed  quite  efficiently. 

" W  (Worst  Element)  This  processor  calls  the  same  routine  as 
does  the  R  command,  but  the  number  of  restructures  allowed  is 
limited  to  one.  (Hence,  W  is  less  efficient  than  R  and  should 
only  be  used  when  there  is  some  reason  to  limit  the  number  of 
restructures.) 

"D  (Deletion)  The  deletion  processor  finds  the  "sharpest" 
element  in  the  mesh  and  deletes  it  by  "squashing"  it  in  its  thin 
direction  provided  no  boundary  conditions  would  be  violated  and 
that  the  quotient  of  the  smaller  diagonal  divided  by  the  larger 
diagonal  in  no  larger  than  tan  (V/2).  (See  V  command.) 

"V  or  +V  Causes  the  parameters  V  used  by  the  D  processor  to 
be  increased  by  2.5°.  The  initial  value  of  V  is  45°.  The  larger 
V  is,  the  more  likely  it  is  that  the  D  processor  will  be  able  to 
delete  an  element  (and  vice  versa). 

"-V  Causes  the  parameter  V  used  by  the  1)  processor  to  be 
decreased  by  2.5°. 

"N  (Necklace)  This  command  causes  an  extra  ring  to  be 
inserted  just  inside  the  perimeter  of  the  region.  This 
'necklacing'  processor  does  no  analysis  to  see  if  this  ring  of 
elements  is  'needed,'  but  just  inserts  it.  Thus,  it  should  never 
be  used  inside  a  loop.  A  necklace  may  be  installed  at  any  time, 
but  the  usual  time  would  be  very  early  in  the  SCHEME,  and  it  will 
often  need  to  be  followed  only  by  a  smoothing  operation. 
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Plot  Commands 


“P  (Plot)  This  command  causes  a  plot  of  the  mesh  in  its  form 
at  that  moment  to  be  done,  provided  a  smoothing  operation  or  a 
structural  change  has  occurred  since  the  last  P  command.  (Thus 
repetitious  plots  are  avoided.) 

"+P  Normally  a  plot  of  the  entire  body  is  done  after  all 
regions  have  been  processed.  However,  if  no  P  commands  are 
encountered  in  processing  any  region,  this  body  plot  is  usually 
skipped.  The  +P  command  requests  that  the  body  plot  be  generated 
even  though  no  Individual  regions  are  being  plotted.  It  only 
needs  to  appear  in  the  SCHKME  for  one  of  the  regions. 

"-P  This  command  causes  the  body  plot  not  to  be  done.  It 
only  needs  to  appear  in  the  SCHEME  for  one  of  the  regions. 

"L  This  causes  a  printer  plot  showing  all  the  nodes  in  the 
region  to  be  done.  This  printer  plot  does  not  show  lines  joining 
nodes,  but  may  still  be  useful,  especially  if  the  region  does  not 
have  any  elements. 

Print  Commands 


"The  parameter  1 1)  E  BUG  in  column  15  of  the  END  card  is  the 
primary  control  over  printing.  In  addition,  the  following 
commands  on  the  SCHEME  card  can  request  dumps  or  timing 
inf  ormat ion  . 

"C  (Current)  This  command  requests  a  dump  of  the  current 
state  of  the  mesh.  Tables  describing  all  elements,  lines,  nodes, 
and  their  interconnections  will  be  printed.  (This  table  is 
rather  large  when  the  mesh  is  large,  so  it  should  only  be 
requested  when  really  needed,  as  for  program  debugging.) 

" B  (Body)  This  command  requests  that  a  complete  list  of  the 
elements  and  nodes  in  the  entire  body  be  printed  after  all 
regions  have  been  processed.  It  only  needs  to  appear  in  the 
SCHEME  card  for  one  region  of  the  body. 

”T  (Time)  The  T  requests  that  the  central  processor  time 
used  by  each  command  be  printed  if  it  is  longer  than  10 
milliseconds.  This  of  course  only  applies  to  commands  appearing 
after  the  T,  so  the  T  should  be  placed  early  in  the  SCHEME  if  all 
timing  information  is  desired. 

”-T  This  command  turns  off  the  printing  that  was  requested 
by  an  earlier  T  command. 

"+T  This  command  causes  the  cumulative  execution  time  for 
this  region  up  to  the  moment  the  +T  is  encountered  to  be  printed. 
The  +T  does  not  conflict  with  the  T  or  -T  Command,  and  it  may  be 
used  as  often  as  desired. 

"I,  See  Plot  Commands. 
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Loop  and  Branching  Command  s 

"A  loop  is  defined  by  enclosing  in  parenthesis  the  portion 
of  the  SC  UK ME  that  is  to  he  repeated.  The  operation  of  all  loops 
is  controlled  by  a  parameter  called  che  'activity  flag'.  This 
flag  begins  in  the  off  state,  and  is  turned  on  by  the  activities 
of  necklacing  (N),  successful  restructures  (  R  or  W),  or 
successful  deletions  (D),  or  the  presence  of  an  'active 
sub  loop ' --i .e  .  ,  a  subloop  which  actually  repeats  at  least  once. 

If  an  activity  occurs  in  a  pass  t  h rough  a  loop,  then  the  loop  is 
repeated  (and  hence  is  itself  'active'). 

" (  The  left  parenthesis  marks  the  beginning  of  a  loop  (or 
subloop).  When  it  is  encountered  the  current  value  of  the 
activity  flag  is  saved  away  on  a  stack  and  then  the  flag  is 
turned  off. 

" )  The  right  parenthesis  marks  the  end  of  a  loop.  If  the 
activity  flag  is  on  at  this  point  the  loop  is  declared  to  be 
active,  the  activity  flag  is  turned  off,  and  control  is 
transferred  back  to  the  first  command  in  the  loop  to  begin  the 
next  pass.  If  the  activity  flag  is  off  ,  the  loop  is  exited. 

Then,  if  the  loop  was  not  active  (i.e.,  it  did  not  repeat  even 
once)  the  activity  flag  is  reset  to  the  value  it  had  when  the 
loop  was  entered.  If  the  loop  was  active,  the  activity  flag  is 
turned  on,  reflecting  that  this  was  an  active  'subloop.' 

” F  (Finished)  If  the  activity  flag  is  off  when  this  letter 
is  encountered,  processing  of  the  mesh  for  this  region  is  usually 
stopped,  just  as  if  the  end  of  the  SCHEME  had  been  reached. 
However,  if  there  is  a  comma  or  period  somewhere  after  the  F, 
then  instead  of  stopping,  control  will  transfer  to  the  first 
command  after  that  next  comma  or  period.  If  the  activity  flag  is 
on  when  the  F  is  encountered,  processing  continues  as  if  the  F 
were  not  present. 

'' C  (Co)  If  the  activity  flag  is  ojn  when  a  C  is  encountered, 
control  transfers  to  the  next  comma  or  period,  if  there  is  one. 

If  there  is  no  comma  or  period,  processing  of  the  mesh  for  this 
region  stops.  If  the  activity  flag  is  o  f 1  when  the  G  is 
encountered,  processing  continues  as  if  the  G  were  not  present. 

",  (comma)  The  comma  acts  as  a  point  for  F  and  G  commands  to 
transfer  to.  Otherwise  it  is  a  'do  nothing,'  and  can  be  used 
like  a  blank  to  clarify  readability  of  the  scheme. 
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Examples  of  Schemes 


"Schemes  may  he  very  simple  to  very  complex  depending  on: 

-  the  amount  of  processing  needed  to  produce  a 
satisfactory  mesh  on  the  region, 

-  the  degree  of  control  of  program  parameters  the 
user  wants  to  exercise, 

-  the  amount  and  kinds  of  output  desired, 

-  the  need  to  experiment  with  different  orders  of 
processes,  etc- 

"The  simplest  possible  SCHEME  card  is  one  with  no  commands 
(i.e.,  the  card  is  blank  except  for  the  word  'SCHEME').  If  there 
are  no  commands  on  the  SCHEME  card  for  a  region,  QMESH  simply 
writes  the  description  of  the  initial  mesh  for  that  region  on  the 
output  tape  (see  description  of  the  REGION  card)  and  proceeds  to 
the  next  region.  Note  this  is  very  different  from  including  no 
SCHEME  card,  in  which  case  the  default  scheme  in  QMESH  is  used. 

At  this  writing  this  default  scheme  is  equivalent  to  the 
following  SCHEME  card: 

Col.  1  Col.  16  or  later 

SCHEME  SP(KS(D)S)P 

This  scheme  plots  the  smoothed  initial  mesh  and  also  the  final 
mesh  if  it  is  different  from  the  first  plot.  The  actual  SCHEME 
used,  whether  it  is  the  default  or  is  user  defined,  will  be 
printed  out  by  QMESH. 

"A  very  simple,  but  often  sufficient  SCHEME  card  is 

S  0  H  E  M  E  P 

in  which  the  initial  mesh  is  simply  plotted  before  the  mesh  is 
written  on  the  output  tape.  Alternatively,  since  the  initial 
mesh  sometimes  has  elements  crowded  too  closely  near  the  boundary 
of  the  reg,  ion,  one  m.iy  smooth  before  plotting: 

SCHEME  SP 

It  no  plots  are  desired,  no  P's  should  appear  in  the  SCHEME. 

Thus,  simply  S,  or  a  blank  SCHi  might  be  used.  Or  to  use  the 
default  SCHEME  except  get  no  plots,  simply  eliminate  the  P's  from 
the  default  scheme:  S(RS(D)S).  Another  possibility  is  to 

request  only  a  final  body  plot  by  using  the  +P  Command. 

"One  can  experiment  with  various  smoothers  by  smoothing  and 
plotting  several  times.  (Of  course  only  the  last  plot  will 
relate  to  the  mesh  description  on  the  tape.)  for  example, 

SCHEME  P  S  P  7 S  P  ISP 
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or,  the  parameters  for  the  ’area  pull  and  Laplaclan’  smoother 
might  be  varied: 

SCHKMK  2  S  P  ASP  ASP 

"Many  meshes  will  benefit  from  the  use  of  restructuring 
alone  is  desired  ( i . e . ,  no  element  deletion),  schemes  such  as  the 
following  can  be  used. 

SCHKMK  ( R S  )  P 

SCHKMK  ( SR  )  P 

The  first  scheme  here  says,  'Attempt  restructuring;  if 
successful,  smooth  and  repeat;  plot  when  done.'  The  second 
scheme  is  almost  identical,  except  a  smoothing  operation  is  done 
before  the  first  restructuring  attempt.  Any  restructuring  which 
then  occurs  will  cause  the  loop  to  repeat,  so  that  the  mesh  is 
always  smoothed  after  restructuring. 

"When  restructuring  is  necessary  to  produce  an  acceptable 
mesh,  it  will  typically  also  be  necessary  to  use  element 
deletion.  There  are  two  basic  r e s t r u c t u r e / d e  1  e t e  loops: 

(SRS(D))  and  ( S  R  S  D ) .  Each  of  these  might  protitably  be  preceded 
by  an  (SR)  loop.  Generally  the  (SRS(D))  loop  would  be  used  with 
large  regions  in  order  to  save  time  in  the  smoothing  routine, 
which  tends  to  be  the  most  costly  operation.  Often,  though,  the 
(SRSD)  loop  will  produce  nicer  meshes  than  the  other  loop  but 
require  more  execution  time.  The  reader  may  wish  to  consider  the 
following  sampling  of  schemes,  each  of  which  could  reasonably  be 
used  on  many  regions. 


SCHEME 

(SRS  (D))  P 

SCHEME 

(SR)( (D)SRS)  P 

SCHEME 

(SWSD)  P 

SCHEME 

((SK)(D)S)  P 

Note  we  have  not  included  in  the  above  any  schemes  with  element 
deletion  but  no  restructuring.  While  this  would  be  possible,  it 
is  felt  that  the  use  of  restructuring  is  preferable  to  use  of 
element  deletion  only.  Also,  it  should  be  noted  that  element 
deletion  should  normally  not  be  used  with  regions  which  are 
intentionally  skewed,  or  tilted,  as  the  deletion  processor  would 
tend  to  go  berserk,  deleting  elements  that  would  be  considered 
normally  shaped.  Of  course  the  -V  Command  can  be  used  to  control 
the  deletion  processor's  appetite.  In  addition,  a  scheme  with  a 
conditional  branch  such  as  the  following  might  be  used  to  avoid 
entering  a  loop  involving  element  deletion  unless  the  region  has 
abnormalities  other  than  just  a  tilt: 

SCHEME  S  R  F  (  (  I)  )  S  R  S  )  ,  1> 
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"The  user  may  experiment  with  alternate  schemes  rather 
easily  by  using  the  initial  mesh  reoriginating  command  (letter 
0).  For  example  (execution  times  are  also  being  printed  here): 

SCHEME  (SRS(D)) P+T  0(SRSD)P+T  0(SR)P+T 

"The  following  schemes  are  presented  without  discussion  to 
illustrate  additional  scheme  possibilities: 

SCHEME  NS  P 

SCHEME  M(SRS(D)P)L 

SCHEME  III  -J-J-J  3S  P 

SCHEME  SR(S  D  SZR)P 

SCHEME  S  IK'.  +VDG  +  V  DC  +VVDCP  .(SRSD)  P 
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Digitizer  File  Format  for  Input  to  Program  PREMESH* 


Card  Number 

Field 

Format 

Description 

1 

2 

1 

1 

2 

A  1  2 

16 

16 

Identification  for  tile 
ITYPE  =  4 

I  CODE  =  -10 

3 

1 

2 

NX1  =  Digitizer  x -coord  i 
first  pu i n  t  ol  transti 
NY  1  =  Digitizer  v-toord i 

A 

1 

2 

11X1  =  Grid  x-ciiordinate 

point 

M  Y  1  =  Grid  y - c  o o  r  d i n  a  t  e 

5 

1 

2 

N  X  1  =  Digitizer  x-coord i 

s  e  c  o  n  <1  po  i  n  t 

NY  2  =  Digitizer  y-coordi 

6 

1 

a 

M  X  2  =  Grid  x-coordin a  t  e 
po  i  n  t 

MY  2  =  Grid  y-coordinate 

7 

1 

2 

NX  3  =  Digitizer  x-coordl 
t  It  i  rd  po  i  n  t 

N Y  3  =  Digitizer  y-coordi 

8 

1 

2 

MX  3  =  Grid  x-coordinate 
point 

MY  3  =  Grid  y-coordinate 

9 

1 

2 

I  CODE  =  -  5 3 3 3  to  start  e 
NVAI,  =  I  d  e  n  t  i  t  y  i  n  g  n  mn  be 

1  '.) 

1 

2 

IX  =  Digitizer  x-coordin 
point  dof  in  i  n g  L 1 N E 

1Y  =  y-coordinate  of  poi 
\.  1  N  E 

*  *  Repeat  types  9  ai  d  10  until  all  lines  are  i 
Curved  boundary  LINKS  should  be  dig  itized  a 
tinely  as  possible.** 

11  1  16  I  CODE  =  -9999  to  end  dig 

input. 


*This  format  may  be  written  by  the  program  DM SOIL. 
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A  P .)  K  N  0  U  M  D-2  :  USER  INSTRUCTIONS  FOR  PROGRAM  EDGRG, 

1 NTERACT I  VE  MKSH  EDITOR 


Purpose 

1.  EDGRG  is  a  utility  program  that  is  used  to  interactively 
edit  TABS -2  computational  meshes. 

Origin  o  f  Program 

2.  EDGRG  was  written  by  D .  P.  Bach  of  the  WES  Estuaries 
Division. 


Description 

3.  EDGRG  reads  the  input  file  for  GFCKN  (output  file  from 
AUTOMSH)  and,  responding  to  interactive  commands,  revises  and 
plots  the  mesh.  It  can  add,  delete,  or  move  elements  and  nodes 
and  fit  curved  boundaries.  At  the  end  of  an  editing  session,  the 
user  can  save  the  output  file,  which  is  a  copy  of  the  input  file 
with  changes  that  have  been  made  during  the  session. 

Use 

4.  EDGRG  requires  a  TE KT RON  I  X - 1 y pe  graphics  terminal. 

Input 

5.  Input  consists  of  a  standard  GFGEN  (Addendum  D-3)  input 
file  and  interactive  commands.  To  begin  mesh  editng  session, 
make  the  GFGEN  input  file  local  by  typing 

GET,  TAPEi  =  filename  <RETURN> 

Then  execute  EDGRG  by  typing 

BEGIN, EDGRG .PROCEV  <  RETU  RN  > 

5.  At  the  beginning  of  execution,  the  program  displays  on 
the  screen  some  information  about  the  input  file  (title,  number 
of  nodes,  elements,  etc.).  When  the  user  presses  the  return  (or 
enter)  key,  the  screen  is  erased,  the  beil  sounds  and  a  " C  ? " 
prompt  appears.  The  C?  prompt  indicates  that  the  prog,  ram  is 
waiting  for  a  command.  Table  D-2-1  lists  Llie  available  commands. 

Interactive  commands 

h.  Windowing.  The  ”W"  command  is  used  to  window  in  on 
portions  of  the  mesh  so  that  the  plotted  mesh  is  larger  and 
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easier  to  review  and  edit.  Five  windowing  methods  are  available. 

7.  Windowing  by  specifying  nodes  at  the  corners  is  per¬ 
formed  by  giving  the  "W"  command  at  the  "C?"  prompt.  The  program 
will  respond  with  ''NODES?.''  The  user  then  keys  in  the  numbers  of 
four  corner  (not  mid-side)  nodes  that  define  the  minimum  and 
maximum  x-  and  y - c o o r d  1  n a t e s  of  the  window.  The  displayed 
line  will  look  like  this: 


C?  W  NODES?  nxmin ,nxmax  ,nymin  ,nymax 

where 


nxmin 

=  node 
side 

with  x-coordinate 
of  the  window 

that 

corresponds 

t  o 

left 

n xma  x 

=  node 
side 

with  x-coordinate 
of  the  wi ndow 

that 

corresponds 

t  0 

right 

nymi  n 

=  node  with  y-coordinate 
of  the  window 

t  tat 

corresponds 

t  o 

bottom 

nymax 

=  node 
the 

with  y-coordinate 
window 

that 

corresponds 

t  0 

top  of 

Using  mid-side  nodes  or  nodes  that  have  a  maximum  below  a  minimum 
will  result  in  a  nonexistent  window. 

8.  Windowing  by  coordinates  is  activated  by  the  ”WC''  com¬ 
mand.  It  wtl  result  in  the  prompt  "COORDINATES."  The  prompt  and 
responses  are: 

C?  WC  COORDINATES?  xm i n , x ma x , y m i n , ym ax 

where  the  coordinate  responses  are  in  actual  units  and  define  the 
desired  window. 


9.  Windowing  around  a  specific  node  or  element  is  obtained 
by  the  "WN"  or  "WE"  command.  The  program  responds  by  asking 
which  node  or  element  is  desired. 

10.  Windowing  by  use  of  the  cross  hairs  requires  that  a 
plot  of  the  mesh  or  of  a  previous  window  be  displayed  on  the 
screen.  In  response  to  the  "C?"  prompt,  type  "C"  <RETURN>  and 
the  cross  hairs  will  appear.  Position  the  crosshairs  at  the 
lower  lefthand  corner  of  the  desired  window  and  type  "W" 
<RETURN>.  The  cross  hairs  will  reappear.  Position  them  at  the 
upper  right-hand  corner  of  the  desired  window  and  type  a  space, 
then  <RKTURN>.  This  completes  definition  of  the  window. 


11.  Once  defined,  the  window  will  remain  in  effect  until 
redefined  or  the  session  ends.  The  PW  command  will  plot  the 
windowed  portion  of  the  mesh. 

i 
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12.  Creating  nodes.  Nodes  ore  created  by  typing  the  "C" 
command  to  display  the  cross  hairs.  When  the  cross  hairs  appear, 
position  them  at  the  location  where  the  node  is  desired,  then 
type  " C“  <RKTUKN>.  The  program  will  assign  a  number  to  the  new 
node.  It  will  then  request  the  bed  elevation  lor  the  new  node 
(prompt  "  K  I,  F.  V  ? "  )  and  slope  (prompt  "SLOPE?"').  It  the  new  nodp 
does  not  lie  on  a  element  side  that  is  to  be  curved,  enter  "NO" 
to  the  "SLOPE?”  prompt.  If  a  slope  is  needed,  it  can  be  speci¬ 
fied  by  typing  in  a  value  or  it  can  be  computed  by  the  program. 

To  have  the  program  compute  slope,  type  in  "COMPUTE"  <RETURN>  , 
in  response  to  the  “SLOPE?"  command.  The  crosshairs  will  then 
appear.  Place  them  at  the  location  on  the  curved  boundary  where 
the  adjacent  mid-side  should  be  located  and  type1  a  space  then 
<KETURN>.  When  all  new  nodes  have  been  created,  type  "CS"  at  the 
"C?"  prompt  and  the  requested  slopes  will  be  computed  by  the 

p  r  o  g  r  a  m  . 

13.  Creating  elements.  When  the  "CE"  command  is  entered  to 
create  an  element,  the  program  will  prompt  with  "NODES?."  In 
response,  type  in  a  list  of  four  corner  node  numbers,  separated 
by  commas,  that  define  the  new  element.  For  triangles,  the 
fourth  node  number  should  be  zero.  The  corner  nodes  should  be 
entered  in  counter-clockwise  order.  The  program  will  assign  an 
element  n  um  her. 

14.  If  the  entered  nodes  correspond  to  an  existing  element 
side  that  is  to  he  curved,  the  program  will  ask  if  the  new  side 
is  to  he  curved  also.  The  request  will  appear  as: 

"Is  SIDE  nodel  node2  node)  to  be  curved?" 

Ii  the  side  is  to  be  curved,  type "YES"  <RETURN>.  If  it  is  not, 
type  "NO"  <RETUKN>. 

15.  The  program  will  assign  a  number  to  the  new  element. 
Output 

16.  E  DC  RG  will  write  a  new  GFCF.N  input  file  at  the  end  of 
the  editing  session.  To  save  it  for  future  use,  you  must  save 
that  file  (TAPE 2) .  "se 

SAVE  ,  T  A  P  E  2  =  lilcname 

17.  A  summary  of  the  editing  session  is  written  to  TAPE91. 
It  a  record  of  the  session  is  desired,  print  TAPF.91  locally  or 
route  it  to  an  R.IE  printer. 

18.  A  list  of  deleted  node  and  element  numbers  that  were 
not  reassigned  during  the  session  are  written  to  TAPE  3.  It  you 
wish  to  reuse  those  nodes  and  elements  later,  save  TAPE  3  and  make 
it  local  for  the  next  editing  session,  then  type  RR  (restore)  at 
the  first  C?  prompt. 
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PC 

PN 

PF. 

W 

WC 
WE 
W  N 
PW 

DN 

C 

cs 

DE 

CE 

F. 

KR 

RS 

Q 


Plot  entire  mesh 

Plot  node  numbers  without  erasing  mesh  on 
screen 

Plot  element  numbers  without  erasing  mesh 
on  screen 

Define  window  on  part  of  mesh  (see  paragraph 
6-11) 

Window  hy  coordinates 
Window  by  element 
Window  by  node 

Plot  that  portion  of  the  mesh  as  defined  hy 
previous  window  (W)  command 
Delete  node.  Program  will  request  node 
number  to  be  deleted. 

Display  cross  hairs.  Used  to  window  and 
create  nodes  (see  paragraph  12) 

Compute  slopes  at  nodes  newly  created  and 
flagged  as  those  to  have  slope  computed 
Delete  element.  Program  will  request  element 
number  to  be  deleted 
Create  element  (see  paragraph  13) 

Exit  F.DGRC  and  write  output  file  (TAPF2  must 
be  saved  to  preserve  results  of  editing) 
Restore  run  (see  paragraph  18) 

Erase  screen 

Query.  Displays  results  of  editing  so  far  in 
present  session 
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Purpose 

1.  G  F  G  K  N  '  s  purpose  is  to  create  a  geometry  and  finite 
element  mesh  file  for  input  to  the  TABS-2  modeling  system  pro¬ 
grams  and  to  plot  the  created  mesh. 

Origin  o  f  Program 

2.  GFGKN  is  composed  of  elements  from  programs  written  by 
Resource  Management  Associates,  Lafayette  ,  California,  and  the 
WKS  Hydraulics  Laboratory. 

I escription 

3.  The  program  GFGKN  has  these  capabilities: 

a.  Read  node  and  element  data  and  construct  a  finite 
element  computational  mesh  for  use  by  other 
programs  in  the  TABS-2  modeling  system. 

b^.  Identify  errors  and  potential  errors  in  the 
constructed  mesh. 

c.  Renumber  the  mesh,  omitting  unused  node  and  element 
n  umbe  r  s . 

d.  Fit  curved  clement  sides  to  land  boundaries  and 
interior  element  sides  as  specitied. 

e.  Develop  an  element  solution  order  that  permits  most 
efficient  operation  of  models  using  the  mesh. 

f.  Print  a  summary  and  create  a  plot  of  the  generated 
mesh. 

g  .  Write  a  tile  that  contains  the  mesh  information  and 
geometry  in  format  suitable  for  use  by  other  TABS-2 
programs . 
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Use 


Curved  Element  Sides 

4.  Curved  element  sides  may  be  created  for  external  bounda¬ 
ries  (the  sides  of  the  model)  or  for  element  sides  within  the 
mesh.  They  may  fit  by  either  or  both  of  two  optional  techniques. 
These  are  described  below: 

5.  Boundary  Option  I.  Slopes  are  specified  at  all  corner 
nodes  where  curved  boundaries  are  to  be  placed  and  a  list  of  mid¬ 
side  nodes  on  the  curved  boundary  is  given.  The  program  calcu¬ 
lates  the  necessary  curved  boundary  to  satisfy  the  specified 
slopes.  If  certain  slope  errors  are  detected,  a  warning  is 
printed.  If  the  fix-slope  option  is  on  (IFXSLPM),  the  program 
attempts  to  modify  specified  slopes  near  the  error  to  eliminate 
it.  Option  I  requires  use  of  the  GC,  CM,  and  perhaps  the  CF 
card. 

b .  Bound  ary  Option  I  I  .  A  starting  corner  node,  a  direction 
to  proceed,  and  an  ending  corner  node  arc  specified.  The  program 
will  automatically  generate  a  smooth,  curved  boundary  from  the 
starting  node  to  the  ending  node.  If  desired,  slopes  at  some 
nodes  can  be  prespecified  and  the  automatic  computation  will 
force  the  curved  boundary  to  meet  that  specified  slope.  Option 
II  requires  use  of  the  GB  and  GS  cards.  After  the  curved  bounda¬ 
ry  has  been  created  once,  change  these  cards  to  GCN  and  GMN  cards 

with  slopes  inserted  to  save  computer  costs. 

7.  Note  that  Option  I  can  be  exercised  on  one  part  of  the 
mesh  and  Option  II  on  another  part.  If  both  options  are  speci- 
fi  d  for  the  same  portion  of  the  mesh,  Option  II  will  override 
Option  I  . 

8.  Problem  elements.  The  shape  described  by  a  curved 

element  side  is  that  of  a  second  order  curve.  It  can  contain 
only  one  inflection  point  between  two  corner  nodes.  An  example 
of  a  curved  boundary  is  shown  in  Figures  0-1-2  and  0-3-1  a.  If  a 

boundary  is  curved  very  sharply,  as  shown  in  Figure  0-3-lb,  then 

the  mid -side  node  will  fall  quite  close  to  one  of  the  adjacent 
corner  nodes.  Mid -side  nodes  that  fall  outside  the  middle  third 
of  the  curved  arc  length  prompt  GFGF.  N  to  issue  a  warning  about 
"middle  third  rule"  violation  and  print  the  traction  of  arc 
length  at  which  the  mid-side  falls.  Middle  third  rule  violations 
that  are  close  to  a  fraction  of  either  0.333  or  (!.bb6  can  usually 
be  tolerated  by  the  models.  Fractions  less  than  0.2  or  more  than 
0.8  usually  lead  to  model  inaccuracy  and  even  instability. 

9.  Sharply  curving  boundaries  can  cause  the  elements  that 
they  border  to  be  poorly  constructed.  GFGF.  N  contains  some  error 
detection  but  cannot  identify  all  potential  errors.  Curved  s i d  e  s 
are  shown  in  Figure  D-3-2.  Part  a  shows  a  well-lormed  element. 
Part  b  shows  a  poorly  termed  element  that  lias  the  curved  boundary 
crossing  the  opposite  side.  Part  c  of  the  tigure  shows  an  e  1  i.  - 
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ment  with  very  sharp  corners.  The  element  in  Figure  l)-"-2b  would 
cause  the  models  to  produce  erroneous  results  or  fail.  The 
element  in  Figure  D-3-2c  might  or  might  not  cause  problems 
depending  on  its  location  in  the  mesh  and  gradients  near  it. 
Poorly  formed  elements  can  be  avoided  in  the  mesh  creation  pro¬ 
cess  by  careful  location  of  corner  nodes.  Fact)  newly  formed  mesh 
should  be  plotted  and  examined  carefully  to  identify  and  remedy 
problems  such  as  shown  in  Figure  D-3-2. 

Reorder ing 


10.  The  simultaneous  equation  solver  used  by  the  models 
runs  more  efficiently  (and  thus,  considerably  more  cheaply)  if 
the  solution  sequence  is  optimized  by  reordering  the  mesh.  Re¬ 
ordering  does  not  change  any  element  or  node  numbers;  it  changes 
the  sequence  in  which  the  elemental  equations  are  assembled. 

11.  The  program  will  attempt  various  reordering  schemes  as 
directed  and  give  the  matrix  bandwidth  and  band  sum  and  front  sum 
for  each  scheme.  It  will  automatically  select  the  ordering 
scheme  that  minimizes  the  front  sum.  The  cost  savings  associated 
with  reordering  are  large  enough  that  it  is  strongly  recommended 
that  the  user  spend  some  time  carefully  generating  the  optimum 
reordering  scheme.  Once  reordering  is  complete,  only  the  best 
list  should  be  used  in  subsequent  runs  so  that  computation  costs 
are  minimized.  Two  options  are  available  for  reordering: 

12.  Reordering  Option  1 .  Option  I  requires  that  the  GO 
card  be  used  to  give  a  starting  list  of  nodes  to  begin  the 
reordering  process.  Many  starting  lists  should  be  tried. 

13.  When  using  Option  I  reordering,  consider  the  following 
points.  In  general,  choose  reordering  lists  that  make  up  a 
continuous  line  along  one  end  of  the  mesh.  Try  lists  on  several 
edges  of  the  mesh  and  of  varying  length.  Be  warned  that  a  very 
short  list  (less  than  five  nodes)  may  cause  the  front  width 
(number  of  equations  assembled  simultaneously)  to  become  too 
large  for  program  dimensions.  Try  inflow  or  outflow  boundaries 
as  reordering  li^ts. 

14.  When  the  starting  node  list  leading  to  the  smallest 
front  sum  is  found,  try  multiple  versions  of  that  list,  including 
slightly  shorter  and  slightly  longer  lists.  Try  reversing  the 
order  that  the  nodes  are  listed  (left  to  right  instead  of  right 
to  left,  etc.). 

15.  Reordering  Option  I  I  .  Option  II  performs  automatic 
reordering  of  the  mesh  without  requiring  a  starting  list  or 
location  like  Option  I.  Option  II  usually  creates  a  reordered 
mesh  slightly  less  efficient  than  that  generated  by  a  rigorous 
application  of  Option  I.  Option  II  is  also  available  in  AUT0MSI1. 

16.  Option  II  cannot  tolerate  missing  elements  (skipped 
element  numbers)  nor  elements  with  negative  values  of  I  MAT  (card 
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GF.).  Because  it  takes  a  substantial  amount  of  processor  time, 
Option  IX  should  not  be  used  as  a  matter  of  routine. 

Input 


17.  Input  consists  of  control  data,  described  here,  which 
are  in  card  image  and  may  be  either  on  cards  or  on  disk  file 
identified  as  logical  unit  08.  Alternate  input  is  a  geometry 
file  previously  created  by  GFGKN.  Input  data  on  logical  unit  08 
are  in  the  standard  TABS  format.  Briefly,  each  card  image  begins 
with  a  two  or  three  character  identification  string  followed  by 
the  data.  Data  may  be  formatted  in  column  fields  or  free  format 
separated  by  spaces  or  commas. 

Output 

18.  Output  consists  of  printed  results,  a  plot  file,  and  a 
geometry  file.  Printed  output  includes  echo  prints  of  input 
data;  a  list  of  elements,  associated  nodes,  and  element  types; 
slopes  at  the  nodes;  a  list  of  boundary  nodes-  high  and  low 
element  and  node  numbers;  unused  element  and  node  numbers. 

19.  F,  r  r  o  r  messages  .  Messages  showing  mesh  errors  are 
printed  if  switched  on  by  the  GF  card.  Three  error  messages  are 
given.  The  Middle  Third  Rule  violation  means  that  a  midside  node 
on  a  curved  boundary  has  been  calculated  to  lie  outside  the 
middle  third  of  the  arc  forming  the  element  side.  As  discussed 
in  paragraph  8  of  this  addendum,  middle  third  rule  violations 
need  not  always  be  fixed.  The  Slope  Rule  Error  indicates  that 
the  slopes  given  at  two  adjacent  corner  nodes  will  cause  the 
boundary  to  reverse  directions  between  the  nodes  as  shown  in 
Figure  D-3-1C.  The  user  may  intend  for  the  reversal  to  occur, 
but  if  not,  a  boundary  discontinuity  exists  that  requires  special 
treatment  in  the  flow  model.  Ill-defined  elements  are  identified 
if  an  element  has: 

<i.  Any  number  of  nodes  other  than  6  or  8. 

b^.  A  node  list  containing  a  zero. 

£.  A  node  list  that  does  not  alternate  corner  and 
midside  node  numbers. 

Keeping  track  o  t  runs 

20.  Keeping  track  of  runs  is  made  easier  by  use  of 
consistent  file  naming  conventions  (Appendix  N),  use  of  a  file 
management  system  (Appendix  N),  and  use  of  job  tracking  sheets  as 
illustrated  in  Figure  D -  3 -  3  . 

Example-Card  Image  Input  Data 


21.  Table  D-3-1  lists  the  card  image  input  data  needed  for 
GFGKN  instructions.  An  example  listing  of  the  card  image  input 
data  file  lor  GFGKN  is  shown  in  Figure  D-3-3.  The  T3,  SI.,  GK  , 
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GFCF.N  JOB  SHEET 

JOB  EXECUTED  _  DATE  OF  RUN  _  TIME  OF  RUN  _ 

JOB  PRINTED _ SUBMITTED  BY  _  SBUS  _  PRI_ _ PO _ 

************  REVISION  NO.  =  _  *********** 

NODES  =  _  REORDERED?  YES  OR  NO 

ELEMENTS  =  _____ _  MESH  CHECK  =  0  OR  1  OR  2  OR  3 

PLOT  =  NO  or  ALL  or  PARTIAL  (if  partial,  give  limits= _ , _ , _ , _ 

ROTATION  =  _  DEGREES 

ELEM  HGHT  =  _ 

NODE  HGHT  =  _ 

*********************************** 

PURPOSE  = 


FIGURE  D-3-3.  GFGEN  job  sheet 
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T3  YAZOO  BACKWATKR  ARKA  -  ALTKRNATIVK  1 

$  L  3,0,6 

GB  315,311,1 

CB  333,336,348 

CB  350,352,392 

GB  388,387,339 

CB  399, 4  0  6, 928 

GB  948,959,994 

GB  971,972,740 

GB  12,15 ,804 

GB  314,310,393 

GC  804  , .  7622 


GO 

2866,986 , 

2870,991 

,  287  6 

,993  , 

2878  , 

994  ,0 

GS 

589,-3. 14 

GS 

455  ,  .  4628 

,449 , .9868 

GS 

5  18 , .6 1 57 

,519,. 6000 

GS 

27  ,-.  667  , 

29 ,-. 57 1 

.37,- 

.9908 

,39,- 

.  9694 

GS 

41,-3.333 

, 137,-2. 

222,232,-4 

.  5  4  5  , 

629,-4. 

08  3 

GS 

87 ,-.2450 

,65, -.255 0,64 

,-.2450,43 

,-.  2  5  50 

PO 

1  ,  1  ,  0 , 0 . 0  0  2  ,  .  0  0  2  , 

0  ,  .07 

,  .07 

G  K 

1  1 

997 

2 

998 

4 

999 

3 

10  00 

2 

GK 

2  6 

1001 

4 

998 

2 

100  2 

5 

1  003 

2 

GR 

3  3 

999 

4 

1  004 

44 

100  3 

43 

1  006 

2 

OK 

4  45 

1007 

44 

1004 

4 

100  1 

6 

1008 

2 

GK 

5  a 

1  009 

6 

1003 

5 

1010 

7 

10  11 

2 

GK 

6  46 

1012 

45 

1008 

6 

1  009 

8 

1013 

2 

GK 

7  8 

10  11 

7 

1014 

9 

10  15 

10 

10  16 

1 

GK 

8  46 

1013 

8 

1016 

10 

1017 

47 

1018 

1 

GK 

9  10 

1015 

9 

1019 

1  1 

1020 

1  2 

102  1 

1 

GK 

10  47 

10  17 

10 

1021 

1  2 

102  2 

48 

1023 

1 

GK 

11  12 

10  20 

1  1 

102  4 

1  3 

1025 

14 

1026 

1 

GK 

1  2  48 

1022 

12 

1026 

14 

1027 

49 

1028 

1 

GK 

13  14 

1025 

13 

1029 

1  5 

1030 

16 

1031 

1 

CF. 

14  49 

1027 

14 

1031 

1  6 

10  32 

50 

1033 

1 

GK 

15  17 

1034 

18 

1035 

1  6 

1020 

1  5 

10  36 

2 

GK 

16  18 

10  37 

5  1 

1038 

50 

103  2 

1  6 

1035 

2 

GK 

17  19 

10  39 

2  0 

1040 

18 

1034 

1  7 

104  1 

2 

CK 

1  8  20 

1042 

52 

104  3 

5  1 

1037 

18 

1040 

2 

GK 

19  2  1 

1044 

22 

1045 

20 

1039 

19 

1046 

2 

GK 

20  22 

1047 

53 

10  48 

52 

1042 

20 

1045 

2 

GK 

2  1  23 

1049 

24 

1050 

22 

1044 

2  1 

105  1 

2 

0 

0 

0 

0 

0 

0 

GNN 

1 

321098.90 

724680.40 

75.00 

C  NN 

2 

321103.40 

724518.60 

7  5.00 

GNN 

3 

321784.60 

724743. 10 

75.00 

GNN 

4 

321784.87 

724532.24 

7  5.00 

GNN 

5 

32  1  105.40 

724356.60 

7  5 . 0  0 

GNN 

6 

321711.39 

724314.76 

7  5.00 

Figure  0-3-4.  Example  input  for  CFCK  N 
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and  CNN  cards  were  written  by  AUTOMSH.  The  only  additional  cards 
needed  to  execute  GFGEN  are  the: 

CB  Automatic  boundary  slope  calculation 

CS  Override  GB-card  option  at  selected  nodes 

GO  Element  reordering  for  more  efficient  computations 

PO  Mesh  plot  details 

22.  AUTOMSH  writes  the  GE-card  for  each  element  (giving  the 
element/node  connection  table,  the  element  type,  and  its  orienta¬ 
tion  in  the  mesh)  and  the  CNN  card  for  each  corner  node  in  the 
mesh  (giving  its  (x,y,z)  location  in  that  sequence.  For  example, 
the  CNN  card  at  the  bottom  of  the  sample  listing  shows 
(321098.90  ,  724880. AO,  and  75.00)  for  the  (x,y,z)  coordinates, 
respectively.  AUTOMSH  prints  all  but  the  z-value,  and  it  sets 
all  z  coordinates  to  "  0  .  "  It  is  necessary  to  obtain  a  plot  of 
the  mesh,  with  node  numbers,  to  determine  the  node  number  for  the 
z-coordinate. 

2).  Notice  also  that  node  numbers  in  the  example  listing 
increase  by  1;  yet  they  are  corner  nodes  only.  Mid-side  node 
numbers  are  included  in  the  element  connection  table  (GB-cards), 
however,  and  will  be  located  by  GFGEN  using  straight  interpola¬ 
tion  if  they  are  not  on  boundary  lines. 

2A.  A  plot  of  the  finite  element  network  is  shown  in  Figuie 
D-3-4.  It  is  the  first  of  three  plot  files  requested  on  the  P0- 
card.  The  second  plot  file  has  the  same  image  as  the  first  plus 
element  numbers  and  the  third  plot  file  has  that  same  image  but 
node  numbers  are  displayed  rather  than  element  numbers.  It  is 
this  plot  which  must  be  requested,  at  map  scale,  to  code  the  z- 
coordinate  for  each  corner  node. 


Input  Instructions 


25.  The  following  pages  provide  instructions  for  preparing 
card-image  run  control  input  to  program  GFGEN.  Table  1)  -  3  - 1 
summarizes  the  input  data  types. 
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GFGF.N 


Figure  0-3-5.  Kxampl c  mesh  plot  produced  by  GFGKN 


NETWORK/GFGEN 
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Table  D-3-1 


'  • 

GFGKN  Version  3.0  Data  Card 

Sequence 

L 

^ _ 

■ 

Card 

Content 

Required? 

Page 

-  , 

T  1  -  T  3 

Titles 

Yes 

D-3-  1  2 

$  K 

Format  control 

No 

D-3-1 A 

a 

$L 

Input/output  files 

No 

D-3-  1  5 

GB 

Boundary  for  automatic 
curve  fitting  to  sides 

No 

D-3-16 

rg 

GC 

Corner  nodes  and  slopes 
for  specified  curve 
fitting  to  sides 

No 

D-3-1  7 

w 

GM 

Mid-side  nodes  on  specified 
curve-fitted  boundaries 

No 

D-3-  1  8 

►  , 

GK 

Mesh  debug  controls 

No 

D-3-19 

a 

.  GG 

Automatic  mesh  generator 
controls 

No 

D-3-20 

■'  . 

GO 

Mesh  reordering  controls 

No 

D-3-2  1 

GK 

Mesh  refining  controls 

No 

D-3-22 

B 

GS 

Specified  corner  node  slopes 
to  override  automatic  slope 
computat ion 

No 

D-3-23 

• 

GX 

Geometry  scales 

No 

D-3-24 

«  - 

PO 

Plot  controls 

No 

D-3-25 

m 

PP 

Partial  plot  controls 

No 

D-3-28 

K-; 

GK 

Element  arrays 

Yes,  if 

GG  not  used 

D-3-2  7 

GN 

Node  descriptions 

Yes,  if 

GG  not  used 

D-3-2 8 

NKTWORK 


DRAFT 


04/85 


T  3  Card 

Title  Cards 

Field 

Variable 

Val  ue 

Descript  ion 

Co  l  1 

ICC 

T 

Co  1  2 

IDT 

3 

2-10 

Title 

Title  information 

required 


D—  3  —  13 


NKTWORK 
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DRAFT 


$F  CARD  Format  Control  Optional 

Field  Variable  Value 


Col 

1 

ICC 

$ 

Col 

2 

IDT 

F 

If 

the  $F  is  present  , 

the 

program  expects 

formatted 

input 

according 

to  ( 3A1 ,F5 .0 ,9F8 .0) 

or  ( 3A1  ,  15  ,918) 

on  all 

cards 

except  for  the  CE  cards  which  are  ( 2  A  1  , 6 X , I 3 , 8 I 4 , I 8  ,  F8 . 0  ) 

.  I  f 

the  $  F 

is  not  included, 

free 

-field  formats 

are  used 

,  and 

variables 

are  separated  by 

spaces 

or  commas  .  If 

free-field 

input 

is  used  , 

variables  on  each 

card 

must  appear  in 

sequence,  even  if 

they  are 

set  to  0 . 

NETWORK 
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OK  AFT 
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Input/Output  Data  Logical  Unit  Numbers  Optional 

Variable  Value  _ Description _ 

ICG  $ 

IDT  L 

LIINIT  +  LU  on  which  results  of  the  network  generation 

are  to  be  written.  This  file  will  serve  as 
input  to  the  models  or  to  another  GFGKN 
run.  Usually  LU  03. 

0  No  output  file  will  be  written. 

IGIN  +  LU  for  an  existing  network  which  is  to  be  read 

in  and  revised.  If,  IGIN  <0,  only  the 
reordering  list  will  be  read.  Usually  LU  04. 

0  No  existing  network  will  be  read. 

LP  +  LU  for  standard  printed  output. 

0  Default  to  6,  line  printer. 

NRPT  +  If  an  existing  network  is  to  be  refined  and  it 

is  desired  to  interpolate  velocities  and 
depths  at  the  refined  nodes:  NRPT  is  the  LU 

on  which  interpolation  information  is  written 
by  program  RKFINE. 

0  No  interpolation  needed. 
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GB 

CARD 

Boundary 

to  be 

Automatically  Fit  with  Curved  Sides  Optional 

Field 

Variable 

Value 

Description 

Co  1 

l 

ICG 

G 

Co  1 

2 

IDT 

B 

Co  1 

3 

ISI 

H> 

1 

LOC 

+ 

Corner  node  at  which  curved  boundary 
computation  is  to  begin. 

2 

LOC  2 

+ 

Next 

corner  node  in  curved  boundary 
computation  (indicates  direction 
that  computation  is  to  go). 

3 

LOC  3 

+ 

Last 

corner  node  in  curved  boundary 
computation. 

4 

Repeat  fields  1 

-3  as 

needed  or  insert  additional  GB 

cards  to  complete  the  lists  of  curved  boundary  com¬ 
putation.  Do  not  break  a  3-field  sequence  between 
cards.  Continuation  cards  are  coded  the  same  as  the 
first  card. 


N  f.TWORK 
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CC  CARD  Corner  Nodes  on  Curved  Sides  Optional 


Field 

Variable 

Value 

Description 

Co  1 

1 

I  CC 

G 

Co  1 

2 

IDT 

C 

Co  1 

3 

I  S  I 

N 

1 

U)C 

+ 

Corner 

node  number 

for 

ALPHA, 

2 

ALPHA, 

+ 

Slope 

at  node  LOC  , 

3 

loc2 

+ 

'  o  r  n  e  r 

node  number 

for 

alpha2 

4 

alpha2 

+ 

Slope 

at  node  L0C2 

5  Continue  coding  until  all  corner  nodes  with  slopes 

are  listed.  Continuation  cards  are  coded  the  same 
as  the  first  card.  Do  not  break,  a  node-slope  pair 
between  cards. 


Not  needed  for  boundaries  where  Option  II  is  used. 


D- 3  -  1  7 


NKTWORK 
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GM  CARD 


Mid-side  Nodes  on  Curved  Sides 


Opt i ona  ] 


Field  Variable  Value 


Description 


Col  1  ICG  G 
Col  2  IDT  M 
Col  3  IS1  N 


1  L0C|  +  Mid-side  node  for  which  location  and 

slope  are  to  be  computed. 

2  LOC^  +  Mid-side  node  for  which  location  and 

slope  are  to  be  computed. 

3  Continue  coding  until  all  midside  nodes  which  are  to 

have  location  and  slope  computed  are  listed.  Continuation 
cards  are  coded  the  same  as  the  first  card. 


Not  needed  for  boundaries  where  Option  II  is  used. 


NETWORK 


D-3-  1  H 


DRAFT 


0  4  /  8  5 


OK  CARD 

Kiel  (I 
Co  l  1 

Co  1  2 

1 


2 

3 


Mesh  Debug  Controls 


Op  t 1  on  a  1 


V  a  r i a  h  1  e  Value 
ICO  G 


Description 


IDT  F 

I  D  K  KU  G  i 

2 

3 

4 

IFXSP  1 

0 

NOD  A  + 


Print  high  and  low  element  and  node  numbers, 
ill-defined  elements,  unused  elements  and 
nodes  bad  slope  specifications,  and  all 
boundary  nodes. 

Perform  all  of  optional  1  plus  generate  node 
cross-reference  list. 

Perform  all  of  options  1  and  2  plus  eliminate 
all  unused  nodes. 

Perform  all  of  option  3  plus  eliminate  undefined 
elements  and  writ"  a  new  CFGKN  input  file 
on  logic  unit  98. 

Attempt  to  correct  slope  rule  errors  at  listed 
nodes  . 

No  slope  corrections. 

List  of  mid-side  nodes  between  corner  nodes  that 
can  be  adjusted  to  correct  slope  rule  errors. 
Limit  of  100.  Continue  coding  on  additional 
cards  if  needed,  starting  with  field  1. 


D-3-19 


NKTWORK 


04/85 


DRAFT 


GG  CARD  Automatic  Mesh  Generator  Optional 


Field 

Variable 

Value 

Description 

Co  1 

1 

ICG 

G 

Col 

2 

IDT 

G 

1 

NY 

+ 

Number  of  element  panels  in  x-direction 

2 

NY 

+ 

Number  of  element  panels  in  y-direction 

3 

XL 

+ 

Mesh  length 

in  x-direction 

4 

XY 

+ 

Mesh  length 

in  y-d i rect ion 

5 

XR 

+ 

x-direction 

geometric  spacing  (usually  1) 

6 

YK 

+ 

y-direction 

geometric  spacing  (usually  1) 

NETWORK 
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c;o 

CARD 

Me  s  h  Reordering 

Opt ional 

Field 

V  a  r  i  a  b  1  e 

Value 

Description 

Co  1 

1 

ICG 

G 

Co  l 

2 

IDT 

0 

1 

I  RO 

1 

2 

3 

Reorder 
given 
Reo  rde  r 
Reorder 

mesh  using  lists  of  starting  nodes 

using  automatic  technique 
using  both  options  1  and  2 

2 

LISTN 

+ 

A  list 

of  nodes  (corners  and 

m  i  d  -s 

ides)  in 

sequence  to  be  used  as  starting  line  in 
reordering.  Multiple  lists  may  be  input. 
The  last  number  in  each  list  must  be  a 
zero  or  negative  number. 

For  continuation  cards,  LISTN  begins  in  the  first  field.  Do  no  repeat 
i RO  for  subsequent  lists.  Reordering  is  strongly  recommended  as  a  last 
step  before  running  the  models.  See  documentation  for  suggestions. 


D-3-2  1 


NETWORK 
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DRAFT 


GR  CARD 


Mesh  Re  f i n i ng 


Optional 


Field 

Variable 

Val  ue 

Description 

Col  1 

ICC 

G 

CoL  2 

IDT 

R 

1-4 

LISTR 

+ 

3  or  4  node  numbers  on  the 
that  will  be  used  to  form 
using  the  cited  nodes  as 
the  new  element. 

One  new  element  per  card. 

existing  mesh 
a  new  e 1 emen  t 
corner  nodes  in 

NETWORK 


D-3-22 


DRAFT 
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GS  CARD 

Fixed 

Boundary  Slopes 

Optional 

Field 

Variable 

Value 

Description 

Co  1  1 

ICC 

G 

Co  1  2 

IDT 

S 

1 

1.0C 

+ 

Corner  node  at  which 
will  be  forced 

automatic  slope  computation 
to  use  specified  slope 

SLOPE  j 

Specified  slope 

Repeat  fields  1  and  2  ns  needed  or  insert  additional  GS 
cards  to  complete  the  list.  Do  not  break  a  location-slope 
pair  between  cards. 
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GX  CARD 

Geome  try  Scales 

Opt  ional 

Field 

Variable 

Value 

Description 

Co  1  1 

ICG 

G 

Col  2 

IDT 

X 

1 

XF  ACT 

+ 

Scale  factor  to  multiply 
to  get  model  distances 

input 

x-coordinates 

by 

0 

Default  is  1 

2 

Y  F  ACT 

+ 

0 

Scale  factor  to  multiply 
to  get  model  distances 
Default  is  1 

input 

y-coordinates 

by 

NETWORK 
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PO  CARD  Plot  Controls  Optional 

Presence  of  this  card  Indicates  that  at  least  one  plot  is  to  be  drawn. 


Field  Variable  Value  _ Description _ 

Col  l  ICC  P 

Col  2  IDT  0 

0  Plot  without  node  numbers  or  elevations 

plotted  . 

Node  numbers  will  be  plotted. 

Corner  node  elevations  will  be  plotted. 

Both  nodes  and  corner  node  elevations  will 
be  plotted. 

2  IPKN*  0  Plot  without  element  numbers  or  IMAT's  plotted. 

1  Element  numbers  will  be  plotted. 

2  Element  types  (IMAT)  will  be  plotted. 

3  Both  element  numbers  and  IMAT's  will  be  plotted 

3  HORIZ  +  Maximum  horizontal  size  of  plot 

n  Use  XSCALE  and  YSCALE 

4  VERT  +  Maximum  vertical  size  of  plot 

0  Use  XSCALE  and  YSCALE 

5  XSCALE  +  Scale  factor  for  x-dimensions 

0  Use  HORIZ  and  VERT 

6  YSCALE  +  Scale  factor  for  y-direction 

0  Use  HORIZ  and  VERT 

7  AR  +  Plot  rotation  in  degrees  clockwise  from 

x-axis 

8  HITEL  +  Height  in  inches  of  element  numbers  on  plot 

0  Default  is  .21 

9  1IITNN  +  Height  in  inches  of  node  numbers  on  plot 

0  Default  is  .21 


Plot  information  is  written  to  logical  unit  99. 

*Each  plot  option  produces  a  separate  plot.  Thus  IP NN  =  3  , 
IPEN  =  0  will  produce  three  plots — one  with  the  mesh  only, 
one  with  node  numbers,  and  one  with  corner  node  elevations. 


1  1PNN*  1 

2 

3 
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PP  CARD  Partial  Plot  Options  Optional 

Presence  of  this  card  indicates  that  a  partial  plot  is  to  be  drawn. 


Field  Variable  Value _ Description _ 

Col  1  ICT  P 

Col  2  IDT  P 

2  NXPM1N  +  Node  number  of  minimum  x  location  in  partial 

plot 

3  NXPMAX  +  Node  number  of  maximum  x  location  in  partial 

plot 

4  NYPM1N  +  Node  number  of  minimum  y  location  in  partial 

plot 

5  NYPMAX  +  Node  number  of  maximum  y  location  in  partial 

plot 


Note  that  windowing  is  performed  after  any  requested  plot  rotation 
if  a  plot  is  rotated  by  the  P0  card.  The  choices  of  maximum  and 
minimum  coordinates  should  be  in  terms  of  the  rotated  plot. 


NETWORK 
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CK  CARD  Klement  Arrays  Optional 


Field 

Variable 

Value 

Description 

Co  1  1 

I  CC 

c 

Col  2 

1  l)T 

K 

1 

JK1.K 

+ 

Klement  number 

2  - ') 

NO  I* 

♦ 

6  or  8  element  node  numbers  beginning  with  any 
corner  and  going  counterclockwise  around  the 
element.  For  triangles,  the  last  two  nodes 

be  entered  as  zero. 

10 

I  MAT 

+ 

Klement  type** 

1  1 

TH 

+ 

Direction  of  eddy  viscosity  tensor  for  this 

type  element. 


* 


For  formatted  reads  this  card  is  read  as  (2A1,6X,I8,8I4,I8,F8.0) 


**  Klement 
coef  f icients 


types  are  used 
and  r  oil);  line  ss 


by  the  KMA-2V  to  define  eddy 
coef  f icients. 


viscosity 


U s  e  on  e 


card 


per  element. 


0-3-27 
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GN  CARD 


Nodal  Descriptions 


Opt  i  o  n  a  1 


Field  Variable  Value 


Description 


Col  1 


Col  2 


Co  1  3 


Coding  options 

Constant  value  to  be  used  at  all  nodes  of  number 
J  and  higher 

Values  to  be  assigned  to  node  J  only  (insert  all 
ISI  =  )fi  cards  before  first  N  card) 


Node  number  (first  node  for  ISI=(i) 


C  0  R  D  (  J  ,  1  ) 


x-coordinate  of  node  J 


C 0 R D ( J  ,2) 


y-co  ordinate  of  node  J 


W  D  (  J  ) 


Bed  elevation  at  node  J 


NETWORK 
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USER  INSTRUCTIONS  FOR  PROGRAM  CONFEG 


Purpose 


1.  CONFEG  is  an  interactive  program  that  reads  a  DMSDIG 
(see  Appendix  E)  digitizer  file  containing  node  numbers  and 
coordinates  and  transforms  the  digitizer  coordinates  into  the 
coordinate  system  of  the  user's  TABS-2  mesh.  The  output  file 
from  CONFEG  can  he  merged  with  other  text  files  to  create  a 
complete  G F  G  E  N  input  data  set. 


Origin  of  the  Program 


2.  CONFEG  was  written  by  Steve  Adamcc  of  WES. 

De script  ion 

3.  A  mesh  node  file  created  by  DMSDIC  has  nodal  coordinates 
given  in  inches.  CONFEG  converts  these  units  to  prototype  feet 
using  an  interactively-input  scale  factor.  The  program  also 
shifts  the  datum  plane  for  depths  as  needed,  using  an 
interactively-supplied  value. 

A.  CONFEG  produces  an  output  file  on  logical  unit  2  (file 
TAPE  2)  that  must  be  saved  and  merged  with  other  data  (using  a 
text  editor)  to  create  a  complete  GFCEN  input  data  set. 


Use 


3.  CONFEG  runs  interactively  with  an  input  digitizer  file 
and  creates  an  output  GFGEN  node  coordinate  file.  Scale  factors 
a n d  an  elevation  datum  reference  are  r e q u e  c  t  e d  interactively  when 
the  program  executes.  The  following  interactive  commands  will 
execute  CONFEG: 

GET , CONFEG/ UN=CEKOH 9 
FTN  ,  I  =  G 0 N  F E G  ,  !.  =  0 

GET , TAPE  1 -XXXXXXX  (DMSDIG  digitizer  file) 

l.G  0 

- PROGRAM  EXECUTES - 

- INTERACTIVE  INPUT  WILL  BE  REQUESTED - 

REPLACE , TAPE2 =YYYYYYY  (CONFEG  output) 


D  -  A  -  1 
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Digitizer  File  Format 


Record 

Number 

Word 

Number 

Format 

Description 

l 

1-10 

10A8 

Problem  title,  80  characters 

2 

1 

115 

Digitizer  x-coordinate  of  reference 
point  1 . 

2 

115 

Digitizer  y-coordinate  of  reference 
point  1  . 

3 

1 

E  1  5 . 0 

Grid  x-coordinate  of  reference  point  1. 

2 

E  1  5 . 0 

Grid  y-coordinate  of  reference  point  1. 

4 

1 

1 1  5 

Digitizer  x-coordinate  of  reference 
point  2  . 

2 

I  1  5 

Digitizer  y-coordinate  of  reference 
point  2 . 

5 

1 

E15.0 

Grid  x-coordinate  of  reference  point  2. 

2 

E  1  5 .0 

Grid  y-coordinate  of  reference  point  2. 

6 

1 

E  1  5 . 0 

flap  scale  (user's  coordinates/ map  inches) 

7  + 

1 

I  10 

Node  number. 

2 

110 

Digitizer  x-coordinate  of  node. 

3 

I  10 

Digitizer  y-coordinate  of  node. 

4 

F  1  0 . 0 

Depth  at  node. 

*  *  Input  a  record  type  7  for  each  node,  execution  ends  when  an 
end-of-file  Is  encountered.** 
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ADDENDUM  D-S:  USER  INSTRUCTIONS  FOR  PROGRAM  FNDNODE 


Purpose 


1.  To  find  the  five  nearest  nodes  within  a  TABS-2 
computational  mesh,  given  a  pair  of  coordinates  in  the  user’s 
coordinate  system  or  in  latitude  and  longitude,  FNDNODE  has  been 
used  to  assign  node  numbers  to  sets  of  field  data  location 
coordinates . 


Origin  of  Program 


2.  FNDNODE  was  written  by  Don  Bach,  WESHE-H. 


Description 


3.  FNDNODE  searches  a  GFGEN  binary  output  file  for  the  five 
closest  nodes  to  each  set  of  input  coordinates.  If  the  user 
inputs  the  coordinates  in  latitude  and  longitude,  a  transforma¬ 
tion  is  made  to  the  user's  grid  coordinate  system,  based  on 
three  transformation  points. 


Use 


4.  FNDNODE  is  accessed  through  PROCLV .  Figure  D-5-1  shows 
the  HELP  section  on  this  program. 


FNDNODE 

PURPOSE-  TO  SPAWN  A  BATCH  JOB  TO  RUN  FNDNODE  ON  TH  205 
CALL — BEGIN .FNDNODE , PROCLV , I D , I  1 FND ,0 1 R 1 , RJE  <CR> 

ID  =  USER  NAME 

l 1 FND  =  INPUT  DATA  FOR  FNDNODE 
0 1 R 1  =  GEOMETRY  OUTPUT,  FROM  CFGEN ,  BINARY 
RJE  =  USER  NUMBER  OF  RJE  PRINTER  FOR  PRINTED 
OUTPUT  DESTINATION  (DEFAULT  =  CF.R0G9 
REVERT.  HELP 

Figure  D-5-1.  PROCLV's  HELP  information  on  FNDNODE 


D-5-1 


NETWORK 


5.  FNDNODE  needs  two  input  files:  a  run  control  card  image 
file  and  a  binary  geometry  file  created  by  GFGEN. 

Output 


6.  Output  consists  or  printed  results  that  show  the 
locations  of  the  five  closest  nodes  to  the  input  coordinates. 

The  distance  of  the  selected  nodes  to  the  coordinate  pair  is  also 
output.  Sample  printer  output  is  shown  in  Figure  D-5-2. 

M'H  IIILE.  *  PROGRAM  TEST  NO.  2»  ATCHAFALAYA  MESH  2»  COORDINATE  CONVERSION 
f  R  .'.N  :‘.F  O'-:  M  A  T I  ON  COORDINATES- 


POINT  l  * 

LAT  * 

29.56986111 

LONG  * 

9 l . 23522222 

X  = 

3B1 183.93 

Y  - 

275345.02 

POINT  2- 

LAT  * 

29.62411111 

LONG  * 

91 • 258 ] 6667 

X  = 

373882.79 

Y  * 

288157,84 

FC'TNT  3- 

LAT  * 

29.67122222 

LONG  = 

91 .23419444 

X  * 

381484.69 

Y  * 

305295 . 16 

DANNFFS  FROM  RMA1  FILE-- 

WISME  DNS  VERSION  1.00.  DATED  OCT  1961.  THIS  FILE  IS  FROM  RMA1-V  VERS 
Il'N  :.v0  DATED  OCT  1981. 

DMS  -  AG02XXXXXXXXGVGSEXXX  GRADE  *  D  PERSON  *  DACH  DESCRIPTION  * 

.  T •1,-F.M  AYA  DAT  STUDY.  MESH  2  (MEDIUM  FINE  GRID.  ENTIRE  AREA t  BASE  GEOMETRY)  ' 

.  I  JAN  02»  2030  NODES »  596  ELEMENTS.  NEW  RE-ORDERING  LIST 

MAT  ION  ID  =  NODE  H  929 

i AT  =  29.63447222  LONG  =  91.24155556 

3 ?9 1 57 . 37  Y  =  291929.57 

Ni'C'E  =  1*29  DISTANCE*. 32344EI00  NODE  =  1930  D I  ST ANCE  =  . 2 1 4 1 2E +  03  NODE*  1931  DISTANCE*  .  42793E+03 
NODE-  i  v  -  t  DISTANCE*.  I  >62ML+04  "Uif'F  -  l‘>X4  DISTANCE*  0.E  +  04 

ID  *  NODE+  1929  +  N0  +  C00RDINATE  +  C0NVERSI0N 
• -  3  1  57  .  £  4  Y  =  291929.40 

N'DE -  19?9  DISTANCE* .OOOOOE+OO  NODE*  1930  DISTANCE*. 21381E+03  NODE*  1931  DI STANCE* . 47762E+03 
NODE*  19  +  T  DISTANCE*.  1  7  A  ?  f  f  ♦  A  4  NODE  =  1*34  DISTANCE*  0.E  +  04 

t  or,  . 


Figure  D-5-2.  Sample  printer  output  from  FNDNODE 


Card  Image  Data  Input  Instructions 


7.  The  run  control  file  starts  with  a  run  title  on  line  1. 
The  three  points  of  transformation  are  next,  followed  by  station 
identifiers  and  the  coordinates  for  which  to  find  the  closest 
nodes.  if  the  three  transformation  coordinates  are  omitted,  the 
code  automatically  assumes  that  no  transformation  from  latitude 
and  longitude  to  the  user's  grid  coordinates  is  to  be  performed. 
FNDNODE  automatically  distinguishes  between  latitude  and  longi¬ 
tude  and  the  grid  coordinates.  After  the  first  card,  all  input 
is  free  field.  The  run  control  input  is  described  in  Table  D-5- 
1.  An  example  run  control  input  file  is  listed  in  Figure  0-5-3. 


Examples 


PROGRAM  TEST  2,  ATCHAFALAYA  MESH  2,  COORDINATE  CONVERSION 
29:35:19.9  91:14:6.8  381183.92  275345.02 
29:37:26.8  91:15:29.4  373882.79  288157.84 
29:40:16.4  91:14:3.1  381484.69  305295.16 
NODF.+  l  9  29  29:38:4.1  91:14:29.6 

NODE+1929+NO+COOR DIN AT E  +  CON VERSION  379157.64  291929.40 


Figure  D-5-3.  Sample  run  control  input  to  FNDNODE 


NETWORK 
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1  80  characters  of  run  title 

1  Latitude  of  transformation  point  1,  in  the  form 

d  d : mm : s  s 

2  Longitude  of  transformation  point  l,  in  the  form 

d  d : mm : s  s 

3  Grid  x-ccordinate  of  transformation  point  1 

4  Grid  y-coordinate  of  transformation  point  1 

1  Latitude  of  transformation  point  2,  in  the 

form  d  d : mm  :  s  s 

2  Longitude  of  transformation  point  2,  in  the 

form  d  d : mm  :  s  s 

3  Grid  x-coordinate  of  transformation  point  2 

4  Grid  y-coordinate  of  transformation  point  2 

1  Latitude  of  transformation  point  3,  in  the 

form  dd :mm  :ss 

2  Longitude  of  transformation  point  3,  in  the 

form  dd :mm  :  ss 

3  Grid  x-coordinate  of  transformation  point  3 

4  Grid  y-coordinate  of  transformation  point  3 

Cards  2  through  4  may  be  omitted  if  no  transformation  is 
to  be  performed. 

1  Up  to  80  characters  of  identifier  for  this  set 

of  coordinates  with  no  embedded  blands  nor 
comma  s 

2  Either  x-coordinate  or  latitude  (in  the  form 

dd:mm:ss)  of  point  to  be  searched  for 

3  Either  y-coordinate  or  longitude  (in  the  form 

dd:mm:ss)  of  point  to  be  searched  for 

Enter  a  card  5  for  each  input  coordinate  pair. 


D-5-3 
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APPENDIX  E:  DIGITIZING  INSTRUCTIONS 


PART  I:  INTRODUCTION 


1.  There  are  two  tasks  that  usually  benefit  from  digitizer 

capability:  (a)  encoding  the  ( x , y ) -coord ina tes  around  regions  in 

the  finite  element  network  and  (b)  encoding  the  (x,y,z)- 
coordinates  for  the  digital  map  of  the  model  area.  TABS-2  pro¬ 
vides  a  digitizer  program,  DMSDIC,  resident  on  the  host  computer, 
that  will  tecelve  data  from  a  Tektronix  4954  tablet  and  create  a 
digitizer  file  for  use  by  the  mesh  generator  programs  and  the 
spatial  data  analysis  programs.  DMSDIG  may  be  used  to  create 
digitizer  files  for  these  TABS-2  programs:  PREMESH,  ELEVGRD, 
REFMT ,  RETPNT,  and  FACGRD.  The  use  of  DMSDIG  to  create  digitizer 
files  for  PREMESH  and  ELEVGRD  is  described  in  this  appendix. 

2.  DMSDIG  is  both  equipment-  and  site-specific.  Although 

the  use  of  DMSDIG  is  more  efficient  and  effective  than  digitizing 
by  hand,  digitizing  on  a  remote  host  computer  is  nonetheless  a 
slow  and  tedious  process.  The  use  of  a  local,  dedicated  micro- 
or  minicomputer  system  for  digitizing  is  far  more  efficient  and 
is  highly  recommended.  (Information  on  microcomputer  versions  of 
DMSDIG  is  available  on  request.)  Therefore  the  digitized  data 
file  structure  is  also  presented  so  those  offices  having  their 
own  digitizing  procedures  can  have  the  flexibility  to  create 
TABS-2  compatible  digitizer  files.  The  structure  of  the  PREMESH 
digitizer  file,  used  in  the  development  of  finite  element  net¬ 
works,  is  described  in  Appendix  D:  Finite  Element  Network  Gene¬ 

ration,  Addendum  D-l:  AUTOMSH.  The  structure  of  the  ELEVGRD 
digitizer  file,  used  in  the  creation  of  digital  maps,  and  other 
DMS-A  compatible  digitizer  file  structures  are  described  in 
Appendix  L:  Data  Management  System  A;  Addendum  L-10:  ELEVGRD, 

Addendum  L-3:  REFMT,  Addendum  L- 1  1 :  RETPNT,  and  Addendum  L-12: 

FACGRD.  Instructions  for  accessing  DMSDIG  are  also  shown  in 
Appendix  L,  Addendum  L- 1 :  DMSDIG. 

3.  The  output  file  from  DMSDIG  is  a  coded  (card  image)  file 
that  can  be  set  up  without  using  DMSDIG  by  simply  reading  coordi¬ 
nates  from  graph  paper  and  keying  them  into  a  file  using  an 
editor. 

4.  DMSDIG  is  an  interactive,  FORTRAN  program  that  accepts 
data  from  the  digitizer  tablet  and  writes  it,  in  coded  form,  to  a 
file. 

5.  Two  plot-back  programs,  DGPLT  and  DIGPLT,  are  provided 

for  quality  control  via  visual  inspection  of  the  digitizer  file. 
DGPLT,  described  in  Appendix  L;  Addendum  L-2 :  DGPLT,  is  used  to 

inspect  DMS-A  compatible  digitizer  files,  including  ELEVGRD 
digitizer  files.  DGPLT  is  a  batch,  FORTRAN  program  that  produces 
Calcomp  plots  on  the  WES  DPS-I  computer.  DIGPLT  is  a  batch, 
FORTRAN  program  used  to  inspect  PREMESH  digitizer  files. 


El 
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Instructions  for  the  use  of  DIGPLT  are  given  in  PART  III  of  this 
Appendix. 

6.  DMSDIG  and  DGPLT  were  written  and  the  initial 
documentation  prepared  by  Mr.  Donald  P.  Bach,  Estuaries  Division, 
Hydraulics  Laboratory  (HL),  WES.  The  digitizer  table  interface 
routines  used  in  DMSDIG  were  developed  by  Mr.  Stephen  A.  Adamec, 
Jr.,  Estuaries  Division,  HL,  WES.  DIGPLT  was  written  by  Mr. 
Ronald  E.  Heath,  Hydraulic  Analysis  Division,  HL,  WES. 
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PART  II:  DIGITIZING  INSTRUCTIONS  FOR  THE 
TEKTRONIX  4954  TABLET 


Map  Selection 


7.  Proper  map  selection  is  critical  to  obtaining  the 
desired  accuracy  during  the  digitizing  process.  The  Tektronix 
4954  tablet  has  a  resolution  of  0.01  in.  with  a  precision  of 
+0.0025  in.  per  inch  of  tablet  surface.  Accumulated  error  over 
the  surface  of  a  well  maintained  tablet  should  not  exceed  +0.10 
in.  In  practice,  few  tablet  operators  will  be  able  to  locate 
points  consistently  with  a  precision  of  +0.02  in.  Consider  that 
0.02  in.  on  a  1 : 2 4 , 000 -s c a  1  e  map  is  40  ft  and  that  an  accumulated 
error  of  0.10  in.  means  that  points  on  opposite  ends  of  the  map 
may  be  displaced  by  200  ft  with  respect  to  each  other.  While 
these  results  might  be  acceptable  for  an  estuary  or  large  river, 
a  larger  scale  map  would  be  required  for  digitizing  a  channel 
with  a  bottom  width  of  150  ft. 


Map  Preparation 


8.  All  maps  (and  other  sources  of  spatial  data)  used  in  the 
study  should  he  referenced  to  the  same  real  (x  ,y  ,z)-coordinate 
system.  State  planar  coordinate  systems  are  recommended  for 
horizontal  control  and  the  National  Geodetic  Vertical  Datum, 

1929,  is  recommended  for  vertical  control.  Maps  should  be 
prepared  for  digitizing  by  writing  the  real  coordinates  of  the 
upper  left  and  lower  right  corners  on  the  map  as  shown  in  Figure 
El.  When  digitizing  for  ELEVGRD ,  the  area  of  interest  must  be 
contained  entirely  within  the  map  boundaries  as  defined  by 
connecting  the  map  corners.  When  digitizing  for  PREMESH,  a  third 
point  with  known  ( x  ,  y ) -c oo rd i na t e s  is  required.  This  point  must 
not  lie  on  a  straight  line  between  the  known  map  corners. 


Digitizer  Instructions 


Ceneral  instructions 

9.  BEFORE  ATTEMPTING  TO  USE  DMSDIG,  study  the  example 
DMSDIG  sessions  for  either  ELEVGRD  (Figure  E2)  or  PREMESH  (Figure 
F.3)  and  read  the  section  on  error  messages. 

Step  1 .  Position  the  map  to  be  digitized  and  its  overlay  (if 

_  used)  on  the  tablet,  smooth  out  any  wrinkles,  and  fasten 

the  map  to  the  tablet  with  drafting  tape.  When  digitizing 
Jata  for  ELEVGRD,  the  map  should  be  carefully  aligned  so 
that  the  map's  coordinate  system  is  parallel  to  the  edges 
of  the  tablet.  Map  alignment  is  not  critical  when  digi¬ 
tizing  data  for  PKEMESH.  There  is  a  dead  area  about  an 
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DHSDIG 

PROGRAM  DHSDIG  —  ENTER  <CR>  FOR  HELP 
WHICH  PROGRAH  IS  TO  READ  MY  OUTPUT  FILE'? 

RESPONSE  1*  ?  ELEVGRD 

ENTER  MAP  NUMBER  AND  DATA  TYPE 
RESPONSE  2*  ?  111.3 

DEPTHS  ARE  TO  BF.  INPUT 
DIGITIZE  UPPER  LEFT  CORNER 
DIGITIZE  UPPER  RIGHT  CORNER 
DIGITIZE  LOWER  LEFT  CORNER 
DIGITIZE  LOWER  RIGHT  CORNER 
ENTER  COORDINATES  OF  UPPER  LEFT  CORNER 
BESEQNSE  3*  ’111.444 

ENTER  COORDINATES  OF  LOWER  RIGHT  CORNER 
RESPONSE  4.  ?  444,111 

DIGITIZE  AREA  OF  INTEREST,  ENDING  INPUT  WITH  THE  SAME  POINT  TWICE 
BE  SURE  TO  USE  A  CLOCKWISE  ROTATION 
8  POINTS  INPUT 

ENTER  -9999  TO  SIGNAL  END  OF  DATA  ENTRY 
INITIALIZING  TO  SINGLE  POINT  HODE 

ENTER  <CR>  TO  TOGGLE  TO  MULTIPLE  POINT  MODE  OR  TO  TOGGLE  BACK 
IN  MULTIPLE  POINT  MODE,  ENTER  THE  SAME  POINT 
1UICE  TO  END  DIGITIZER  INPUT 
ENTER  DEPTH 


RESPONSE  3. 


RESPONSE  i. 


RESPONSE  5. 


RESPONSE  6, 


RESPONSE  Z» 


RESPONSE  8. 


RESEONSE  2* 


RESPONSE  IQ* 


RESPONSE  1U 


RESPONSE  12, 


RESPONSE  13t 


RESPONSE  14, 


TOGGLED  TO  MULTIPLE  POINT  MODE 
ENTER  DEPTH 

7  15 

DIGITIZE  DEPTH  LOCATION(S) 

ENTER  DEPTH 

7  14 

DIGITIZE  DEPTH  LOCATION(S) 

ENTER  DEPTH 


TOGGLED  TO  SINGLE  FOINT  MODE 
ENTER  DEPTH 

7  17 

DIGITIZE  DEPTH  LOCATION(S) 

ENTER  DEPTH 

7  21 

DIGITIZE  DEPTH  LOCATION(S) 


TOGGLED  TO  MULTIPLE  POINT  MODE 
ENTER  DEPTH 

7  25 

DIGITIZE  DEPTH  LOCATION(S) 

ENTER  DEPTH 

7  -9999 

RUN  COMPLETE,  SAVE  TAPE 3  H! 

/SAVE  »TAPE3=NEISHB1 


Figure  F.2  .  F.LKVCRD  digitizing  session  sample 
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GET  >DMSPIG/IIN-CER0H9 
DMSDIG 

PROGRAM  DMSDIG  --  ENTER  <CR>  FOR  HELP 
UHTCH  PROGRAM  IS  TO  READ  MY  OUTPUT  FILE7 
RESPONSE  1*  7  PREMESH 

ENTER  FILE  ID 
RESPONSE  2*  7  UATF'RE 

DIGITIZE  TRANSFORMATION  POINT  41 
ENTER  COORDINATES  OF  TRANSFORMATION  POINT  *1 
RESPONSE  3*  7  1100,1200 

DIGITI7E  TRANSFORMATION  POINT  *2 
ENTER  COORDINATES  OF  TRANSFORMATION  POINT  *2 
RESPONSE  4.  7  600 ,500 

DIGITIZE  TRANSFORMATION  POINT  43 
ENIFR  COORDINATES  OF  TRANSFORMATION  POINT  43 
RESPONSE  5.  7  1400,800 

ENTER  -9999  TO  EXIT  PROGRAM 
ENTER  PREMESH  LINE  NUMBER 
RESPONSE  6*  7  1 

DIGITIZE  POINTS  DEFINING  LINE,  ENDING  WITH  A  DOUBLE  POINT 
2  POINT  LOCATIONS  INPUT 
ENTER  PREMESH  LINE  NUMBER 
RESPONSE  2*  7  2 

DIGITIZE  POINTS  DEFINING  LINE,  ENDING  UITH  A  DOUBLE  POINT 

9  POINT  LOCATIONS  INPUT 
ENTER  PREMESH  LINE  NUMBER 

RESPONSE  S.  7  3 

DIGITIZE  POINTS  DEFINING  LINE,  ENDING  UITH  A  DOUBLE  POINT 
2  POINT  LOCATIONS  INPUT 
ENTER  F'RFMESH  LINE  NUMBER 
RESPONSE  2*  7  4 

DIGITIZE  POINTS  DFFINJNG  I  INF,  ENDING  UITH  A  DOUBL  E  POINT 

10  POINT  LOCATIONS  INPUT 
ENTER  PREMESH  LINE  NUMBER 

RESEONSE  IQ.  7  -9999 

RUM  COMPLETE,  SAVE  TAPE3  HI 

0.090  CP  SECONDS  EXECUTION  TIME. 

RESEONSE  11.  ’REPLACE , TAPE3-PRE  IN 
PREIN  REPLACED 


F  i  1 1  r  e  K  1 .  !’  K  K  M  K  S  H  N  i  i  t  i  z  i  ri  £  sample  session 
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inch  wide  around  the  edges  of  the  tablet.  No  data  can 
be  digitized  in  this  area. 

Step  2 .  Turn  on  power  for  the  Tektronix  4014  terminal  and 
the  digitizer  controller. 

Step  3 .  Log  in  to  the  host  computer  where  DMSDIG  is  installed. 

Step  4 .  Execute  the  DMSDIG  program  as  documented  in  Appendix  L 
of  this  man ua  1  . 

Data  entry 


10.  DMSDIG  uses  prompts  and  informative  messages  to  guide 
the  tablet  operator  through  the  digitization  process.  The 
process  always  begins  with  the  request  "Which  program  is  to  read 
my  output  file?"  The  operator  should  respond  by  entering  the 
name  of  the  program  from  the  keyboard,  as  shown  in  Figure  E2, 
Response  1.  A  list  of  valid  program  names  can  be  obtained  by 
entering  only  a  carriage  return.  (The  symbol  <CR>  means  carriage 
return.)  Prompts  beginning  with  “ENTER”  are  requests  to  enter 
data  from  the  keyboard.  Prompts  beginning  with  “DIGITIZE"  are 
requests  to  enter  one  or  more  points  by  positioning  the  digitizer 
mouse  cross  hairs  over  the  point  to  be  digitized  and  pressing  any 
button  on  the  mouse. 


ELEVGRD 


11.  This  option  is  used  to  encode  bed  elevations  or  depths 
by  encoding  multiple  points  having  the  same  value,  tracing  a 
contour,  or  encoding  a  value  for  each  (x,y)  point  digitized. 
ELEVGRD  uses  the  data  from  the  digitizer  file  to  produce  an  array 
of  values  on  a  regular  grid.  Figure  E2  is  a  sample  digitizing 
session  for  ELEVGRD. 


Res  ponse  1  . 
Response  2. 


Digitize : 

Re  s  ponse  3 . 


Response  4. 
Digitize: 


Keyboard  entry:  ELEVGRD<CR> 

Keyboard  entry:  map  number  , data  type<CR> 

Map  number:  user-defined,  up  to  six  digits 

Data  type:  3  for  encoding  depths 

4  for  encoding  bed  elevations 

The  map  corners  one  point  at  a  time  as  requested 

Keyboard  entry:  x,y<CR> 

( x , y ) -coo r d i n a t e s  of  upper  left  map  corner 
Must  be  integer  values  of  six  digits  or  less. 

( x  ,y ) -coord  inat es  of  lower  right  map  corner. 

Perimeter  of  study  area  (area  of  interest),  starting 
and  ending  on  the  same  point. 
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Response  5 


Keyboard  entry:  <CR> 


Response  6. 


Digitize: 

Response  7  . 
Response  8  . 

Response  9. 
Digitize: 
Response  10 . 
Response  1 1 . 
Response  12. 
Response  13. 

Response  14. 


Enter  and  digitize  the  first  depth  value. 

Depth  below  reference  plane 

Must  be  an  integer  value  of  six  digits  or  less. 

One  or  more  points  (or  a  depth  contour) 
at  the  depth  entered  for  Response  6. 

Enter  and  digitize  a  new  depth  value 

Keyboard  entry:  <CR> 

Switches  from  multipoint  mode  to  single-point  mode 
Keyboard  entry:  depth<CR> 

The  location  of  this  depth  value. 

Enter  and  digitize  a  new  depth  value. 

Switch  back  to  multipoint  mode. 

Enter  and  digitize  a  new  depth  value. 

Keyboard  entry:  -9999<CR> 

This  entry  terminates  the  execution  of  DMSD1G. 
Keyboard  entry:  S AVE , T AP E 3 =p f n 

where  pfn  is  the  permanent  file  name 


A  sample  digitizer  file  that  could  have  been  generated  by  this 
session  is  shown  in  Figure  E4.  The  digitizer  file  should  be 
checked  for  errors  before  any  attempt  is  made  to  process  it  via 


ELEVGRD . 


PREMESH 


12.  This  option  is  used  to  encode  the  (x,y)- coordinate 
forming  PREMESH  lines.  The  AUTOMSH  program,  which  includes 
PREMESH,  uses  the  digitizer  file  to  define  the  boundaries  of 
regions  usel  'or  network  generation.  Figure  E3  is  a  sample 
DMSDIG  session  for  PRF.MESH. 


Response  1. 
Response  2. 

Digitize : 


Keyboard  entry:  PRF.MESH<CR> 

Keyboard  entry:  file-id<CR> 

One  to  six  character  user  defined  title 
The  first  transformation  point 


EH 
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[*] 


3 

2000 

2000 

0 

0 

444 

111 

0 

220 

345 

140 

400 

350 

319 

355 

330 

15 

140 

319 

200 

160 

300 

310 

14 

220 

345 

250 

17 

355 

21 

330 

25 

400 

350 

-9999 


MAP  NO.  AND  DATA  TYPE  3=DEPTH 
DIGITIZER  TABLET.  UPPER  LEFT  CORNER 
DIGITIZER  TABLET.  UPPER  RIGHT  CORNER 
DIGITIZER  TABLET.  LOWER  LEFT  CORNER 
DIGITIZER  TABLET.  LOWER  RIGHT  CORNFR 
UPPER  LEFT  CORNER  (x.a),  KEYBOARD 
LOWER  RIGHT  CORNER  (x.a).  KEYBOARD 
FLAG 

BEGIN  (x.»>  COORDINATES  OF  BOUNDARY 
AROUND  STUDY  AREA 


END  OF  STUDY  AREA  BOUNDARY  COORDINATES 
DFPTHS1  FOLLOWED  BY  THEIR  LOCATIONS 


END  OF  FILE 


Figure  E4 .  Sample  digitizer  file 
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Three  transformation  points  are  used  to  determine 
grid  rotation  and  scaling.  These  points  must  not 
lie  on  a  straight  line. 

Response  3.  Keyboard  entry:  x,y<CR> 

( x  ,  y  ) -coord i na te s  of  first  transformation  point. 
Integer  values  of  six  digits  or  less. 

Response  4.  Digitize  second  transformation  point  and  enter  its 
coord inates  . 

Response  3.  Digitize  third  transformation  point  and  enter  its 
coordinates  . 

Response  6.  Keyboard  entry:  1 i ne-n urn b e r < C R> 

PREMESH  line  number,  an  integer  value  <  1000. 

Line  numbers  do  not  have  to  be  entered  in  order. 

Digitize:  Line  segment  ending  with  a  double  point. 

Response  7.  Enter  new  line  number  and  digitize  new  line. 

Response  8.  (Same  as  Response  7) 

Response  9.  (Same  as  Response  7) 

Response  10.  Keyboard  entry:  -9999<CR> 

Terminates  execution  of  DMSDIG. 

Response  11.  Keyboard  entry:  REP L AC E  ,  T AP E 3  =  p f n < C R> 

where  pfn  is  the  permanent  file  name. 

Figure  E5  is  a  sample  PREMESH  digitizer  file  that  could  have  been 
generated  by  this  session.  The  file  should  be  checked  for  errors 
before  any  attempt  is  made  to  process  it  via  AUTOMSH.  DIGPLT  can 
be  used  to  quickly  locate  most  of  the  common  errors. 

Error  Messages 

*  REENTE  R  LAST  LINE* 

13.  This  message  indicates  that  the  host  did  not  receive 
part  of  the  signal  transmitted  by  the  digitizer.  This  may  occur 
if  the  operator  attempts  to  digitize  points  faster  than  the  host 
can  receive  them.  If  digitizing  a  map  corner  or  transformation 
point,  terminate  the  session  and  start  over.  When  digitizing 
point  locations  for  F.LEVGRD  or  PREMESH  lines,  recovery  is  accom¬ 
plished  by  terminating  that  line  and  reentering  the  entire 
sequence  of  points.  The  digitizer  file  will  contain  both  the  bad 
and  good  points  at  the  end  of  the  session,  and  the  bad  sequence 
must  be  edited  out  of  the  file  after  the  session. 
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UATPRE 

4 

10 

HAP  NUMBER  AND  DATA  TYPE 

800 

900 

TRANSFORMATION  POINT  NO.  1  ON  THE  TABLET 

1100 

1200 

COORDINATES  OF  POINT  NO.  1 

300 

200 

TRANSFORMATION  POINT  NO.  2 

600 

500 

COORDINATES  OF  POINT  NO.  2 

1100 

500 

TRANSFORMATION  POINT  NO.  3 

1400 

800 

COORDINATES  OF  POINT  NO.  3 

-5555 

1 

FLAG  TO  BEGIN  (x.y)  COORDINATES  OF  LINE  1 

1000 

830 

500 

800 

-5555 

2 

FLAG  FOR  LINE  2 

500 

800 

450 

750 

400 

700 

380 

640 

370 

600 

400 

490 

440 

410 

480 

330 

500 

350 

-5555 

3 

FLAG  FOR  LINE  3 

500 

350 

1100 

200 

-5555 

4 

FLAG  FOR  LINE  4 

1100 

200 

1160 

280 

1230 

292 

1300 

300 

1340 

410 

1360 

504 

1320 

620 

1250 

710 

1130 

790 

1000 

830 

-9999 

-9999 

FLAG  TO  END  DATA  FILE 

» 

Figure 

E 5 .  Sample  PREMESH  digitizer  file 
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ERROR,  UNSUPPORTED  PROGRAM 


14.  The  response  to  the  question:  "Which  program  is  to 

read  my  output  file?"  was  not  recognized.  Check,  the  spelling  and 
try  again. 

< -  ERROR  IN  COL.  It  ,  RETYPE  RECORD  FROM  THIS  FIELD 

15.  The  host  receved  input  in  a  format  other  than  the  one 
it  expected.  Reenter  the  data  as  instructed. 

Miscellaneous  errors 


16.  The  appearance  of  blank  lines  on  the  terminal  screen 
while  the  operator  is  digitizing  a  sequence  of  points  indicates 
that  the  host  is  not  receiving  all  of  the  digitized  points.  Slow 
down  and  reenter  the  entire  sequence  of  points.  The  bad  sequence 
is  retained  in  the  digitizer  file  and  must  be  deleted  after  the 
session  . 

17.  When  entering  PREMESH  lines  or  using  the  ELEVGRD 
multipoint  mode,  each  sequence  of  digitized  points  is  terminated 
by  digitizing  the  same  point  twice.  If  the  digitizer  mouse  is 
accidently  moved  and  DMSDIG  does  not  recognize  the  double-point 
entry,  try  again  and  edit  the  extra  points  out  of  the  digitizer 
file  after  the  session. 
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FART  III:  PLOTTER  INSTRUCTIONS,  DIGPLT 


18.  PREMESH  digitizer  files  are  plotted  with  DIGPLT,  a 
batch,  FORTRAN  program  that  creates  a  meta-file  (plot  file)  that 
can  be  displayed  on  a  graphics  device  using  the  DIRECT  program 
described  in  PART  II  of  Appendix  I:  Graphical  Output,  Meta 
System.  The  meta-file  contains  only  one  plot  frame.  An  example 
plot  is  shown  in  Figure  E6. 

19.  DIGPLT  is  dimensioned  to  handle  a  total  of  20,000  (x,y) 
digitizer  points  and  200  PREMESH  lines.  The  only  input  required 
by  DIGPLT  is  the  PREMESH  digitizer  file  generated  by  DMSDIG  which 
is  read  from  unit  1.  The  meta-file  is  written  on  unit  99  and  is 
the  only  output  generated  by  the  program. 

20.  DIGPLT  is  normally  executed  on  the  host  computer  from  a 
Tektronix  4014  compatible  graphics  terminal  via  the  PROCLV 
command  sequence: 

BEGIN, DIGPLT, PROCLV, 11G1 , P 1 DG 


whe  re 


I  1 G 1  =  digitizer  file  name 

P 1 DG  =  plot  file  name 

The  DIGPLT  procedure  in  PROCLV  makes  an  internal  call  to  the 
PROCLV  procedure,  META,  after  the  plot  file  has  been  saved.  The 
META  procedure  executes  the  DIRECT  program,  and  the  user  can 
display  the  plot  file  by  entering  one  or  more  of  the  DIRECT 
commands  described  in  PART  II  of  Appendix  1. 
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PART  IV:  OPERATING  INSTRUCTONS  FOR  THE  DIGITIZER 
AT  THE  WES  INSTRUMENTATION  SERVICES  DIVISION 


21.  The  following  steps  apply  to  the  digitizer  in  the 
Instrumentation  Services  Division  (ISD)  at  WES: 

Step  1 ■  Carefully  lay  the  map  to  be  digitized  and  ts 
overlay  (if  used)  on  the  tablet  with  the  map’s  coordinate  system 
parallel  to  the  tablet’s  lower  edges.  Smooth  out  any  wrinkles 
and  fasten  the  map  to  the  tablet  using  drafting  tape.  Remember 
that  there  is  a  dead  area  that  is  about  1-in.  wide  around  the 
edges  of  the  tablet.  No  data  can  be  obtained  within  this  dead 
area. 


Step  2 .  Turn  on  power  for  all  of  the  equipment,  including 
the  digitizer  controller,  the  tape  handler,  and  the  Monsanto 
counter  (if  connected). 

Step  3 .  Install  a  wire  ring  on  the  back  side  of  a  magnetic 
tape.  Mount  and  thread  the  tape.  After  threading,  push  the  load 
button  twice. 


Step  4 .  Make  sure  that  the  switch  on  the  digitizer 
controller  is  set  to  "ABSOLUTE." 


Step  5 .  Make  sure  that  the  record  mode  switch  on  the 
digitizer  controller  is  set  to  "POINT." 

Step  6.  Make  sure  that  the  fixed  data  switches  on  the 
digitizer  controller  are  set  to  "0011." 


Step  7 .  If  digitizer  data  are  already  present  on  the  tape, 
set  the  switch  on  the  buffer  controller  to  "FILE  SEARCH."  Push 
the  buffer  controller  reset  button.  Put  the  tape  controller  on¬ 
line  by  pushing  its  on-line  button.  The  tape  should  skip  one 
file.  More  files  can  be  skipped  by  taking  the  handler  off-line, 
then  back  on-line  for  each  file  to  be  skipped.  The  on-line  button 
will  light  up  when  the  handier  is  on-line. 

Step  8.  Set  the  mode  switch  on  the  buffer  controller  to 

"writeT5 

Step  9.  Push  the  master  reset  button  on  the  digitizer 
control ler. 


Step  10.  Push  the  reset  button  on  the  buffer  controller. 

Step  11.  Put  the  tape  handler  on-line,  if  it  is  not 
a  1  ready . 

Step  12.  For  each  point  to  be  digitized,  carefully  place 
the  cross  hairs  of  the  digitizer  mouse  at  the  exact  point 
location  on  the  map  and  push  any  button  on  the  mouse  to  record 
the  point  location.  The  magnetic  tape  should  advance  one  record. 
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Step  13.  Use  the  digitizer's  keyboard  to  add  alphanumeric 
data.  The  special  fill  button  will  finish  off  any  short  records 
with  blanks.  Do  not  use  the  return  key. 

Step  14.  Alternate  steps  10  and  11  to  obtain  the  correct 
format  for  the  program  that  is  to  read  this  digitizer  data. 

Step  15.  When  finished,  add  two  end-of-file  marks  to  the 
end  of  the  tape  by  pushing  the  EOF  button  on  the  buffer 
controller  twice.  Put  the  tape  handler  off-line.  Rewind  the 
tape  by  pushing  the  rewind  button  on  the  tape  handler.  When  the 
tape  is  rewound,  it  may  be  unloaded  by  pushing  the  load  button  on 
the  handler. 

22.  ISD's  digitizer  will  write  tapes  in  the  following 
format  : 

12  character  records  (216  format) 

1  record  per  block 
9-t  racks 

800  bpi 
odd  parity 

ASCII  character  set  with  ASCII  parity  bit  low 

23.  The  digitizer  tape  may  be  read  by  the  WES  DPS- 8  and 
stored  on  disc  by  the  following  GCOS  job  control  (executed  from 
the  time-sharing  CONVERT  subsystem): 

105SN 

20$  :  IDENT:userid .name 

30$  :  OPT  I  ON: FORTRAN , NOMAP 

40$ : FORTY :  NFORM  ,  NLNO , NLST  IN 

50$ : SELECT ( user no/ PGRM/NEWCOPE , R) 

100$ : EXECUTE 

1 10$ : FFILE :01 .NSTDLB .NOSRLS , FIXING/ 3 , BUFS I Z / 3 , AS A  9 
120$:TAPE9:01,X1D,, digitizer  tape  no .  ,  ,  DEN 8 
130$:FILF.:02,X2D,10L,  NEW,  filename 
132$: DATA : I* 

134$number  of  files  on  the  tape 
140$:ENDJ0B 

24.  Once  the  digitizer  data  are  on  the  DPS-8  disk,  line 
numbers  must  be  added  by  using  the  following  time-sharing 
commands : 


OLD  f ilename 
SEQUX  10001,1 
RES  A  f i lename 

If  any  data  fill  the  first  field  of  six,  an  extra  blank  will  be 
added  between  the  line  number  and  the  data  value  that  must  be 
removed  using  the  text  editor.  If  this  file  is  to  be  used  on  any 
other  computer  the  line  must  be  removed  by  using  the  "STRIP" 
command . 
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2  5  .  The  digitizer  data  can  be  read  and  written  to  a  tape 
that  can  be  read  over  an  RJE  using  the  following  GCOS  job 
control : 


1  0  $  $  N 

15$:  [|)KNT:userid  ,name 

20$ OPT  ION : FORTRAN , NOMAP 

30$ : FORTY :N FORM, NLNO.NLST IN 

40$$SELECT(userno/PGRM/NEWC0PE  ,  R) 

80$ : EXECUTE 

9  0$  :  FFILE  :  02  ,  NSTDLB  ,  NOSRLS  ,  FIXLNC/3  ,  BUFSI  Z/  3  ,  AS A9 

10  0$ :TAPE9:01  ,X1D,  .tape  number,  ,  DEN8 
l  10$  :  FI  LF.  :02  ,X2S  ,  10L,m 

112$: DATA: I* 

114//  number  of  files  on  the  tape  (n) 

1  20$ : UTL2 
1  30$  :  FII.E:  XN.X2D 

140$:TAPE9:OT,1T1D,,,, filename,, DEN8 
1 50F0EF  IN, GFRC, ASCII. 

160FDEF  OT ,NLA»  ,  I BM ,CI80 , F80 . 

170F0PT  IN  AND  OT.RECCT. 

1 80  P  ROC  REWIND  IN.  COPY  IN  TO  OT  nFILES. 

190$: ENDJOB 

The  above  JCL  creates  a  digitizer  tape  having  the  following 
characteristics  : 


80  character  records 
1  record  per  block 
9  tracks 
800  bpi 
odd  parity 

EBCDIC  character  set 
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APPENDIX  K :  R.MS-2V  USER  INSTRUCTIONS 
VERSION  3.0 

PART  I :  INTRODUCTION 


Purpose 


1.  This  program  computes 
z  o  n  t  a  1  velocity  components  tor 
2  -  I)  flow  fields. 


water-surface  elevations  and  hori 
si1 1<  critical,  tree-surface  flow  in 


Origin  of  the  Program 


2.  The  original  R M A - 2  was  developed  by  Norton,  King,  and 
Orlob  (1973),  of  Water  Resources  engineers,  for  the  Walla  Walla 
District,  Corps  of  Engineers,  and  delivered  in  1973.  Subsequent 
enhancements  have  been  made  by  King  and  Norton,  now  with  Resource 
Management  Associates,  and  by  the  WHS  Hydraulics  Laboratory, 
culminating  in  the  version  of  the  code  supported  in  the  TABS-2 
system.  Personnel  in  the  Estuaries  and  Hydraulic  Analysis  Divi¬ 
sions  of  the  WES  developed  a  new  data  input  module,  changed  from 
Chezy  to  Manning's  roughness  equation,  added  various  output  con¬ 
trols,  and  streamlined  the.  program  for  vector  processing. 

Potential  Applications 

3.  Tii  is  program  is  designed  tor  tar-field  problems  in  which 
vertical  accelerations  are  negligible  and  the  velocity  vectors  at 
a  node  generally  point  in  the  same  airections  over  the  entire 
depth  of  the  water  column  at  any  instant  of  time.  It  experts  a 
homogeneous  fluid  with  a  free  surface.  Both  steady-  and 
unsteady-state  problems  can  be  analyzed.  A  surface  wind  stress 
can  be  imposed. 
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Limitations 

9.  Tii  is  prop,  ram  is  not  designed  for  near-lie  Id  problems 
wti  e  r  e  flow-structure  interactions  (like  vortices,  vibrations,  or 
vertical  acf cl erat inns )  are  of  interest.  Areas  of  vertically 
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stratified  flow  are  beyond  this  program’s  capability  unless  it  is 
used  in  a  hybrid  modeling  approach.  It  is  2-D  in  the  horizontal 
plane,  and  zones  where  the  bottom  current  is  in  a  different 
direction  from  the  surface  current  must  be  analyzed  with  con¬ 
siderable  subjective  judgment  regarding  long-term  energy  con 
siderations.  It  is  a  free-surface  calculation  tor  subcritical 
flow  problems. 


w 
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PART  II:  PROCRAM  DESIGN 


Design 


b.  The  program  is  designed  to  be  a  fixed-bed,  hydraulic 
computation  with  the  resulting  wa t e r- s u r f ace  elevations  and  velo¬ 
city  components  written  to  a  file  in  a  batch-oriented  mode  of 
computer  operation.  It  uses  a  finite  element  technique  to  solve 
the  Reynolds  form  of  the  Na v i e r-S t oke s  equations  for  turbulent 
flows.  Friction  is  calculated  with  a  Manning's-type  equation  and 
eddy  viscosity  coefficients  are  used  to  define  turbulent 
exchanges.  A  version  soon  to  be  released  uses  an  extra  equation 
to  compute  turbulent  exchanges  rather  than  a  constant  eddy 
viscosity. 

7.  All  input  data  are  expected  to  be  in  English  units  and 
all  output  files  are  in  English  units.  A  new  version,  soon  to  be 
released,  will  accept  input  data  and  produce  output  data  in 
metric  (SI)  units  at  the  user's  option. 

K.  In  its  original  formulation,  the  model  used  unit  dis¬ 
charge  as  the  flow  variable  and  no  wetting  and  drying  of  the  mesh 
was  allowed.  This  version  of  the  code,  RMA-2V,  uses  velocity  as 
the  flow  variable  and  allows  the  mesh  to  change  with  the  varia¬ 
tion  in  stage  during  a  simulation.  To  accomplish  this,  the 
original  program  was  modified  to  define  wet  and  dry  elements  at 
each  solution  step  so  that  no  depth  was  allowed  to  go  below  the 
prestated  nominal  outline.  A  coordinate  system  was  adopted  as 
illustrated  in  Figure  FI. 


Governing  Equations 


(The  following  paragraphs  are  copied  from  Norton  and  King  (1977).) 
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where 


u 


v 


x  .y  .t 


8 

a 


velocities  in  the  Cartesian  directions 
Cartesian  coordinates  and  ti  .  e 
density 

acceleration  due  to  gravity 
elevation  of  bottom 


h  =  depth 


r*,ry 


external  traction,  in  this  case  bottom 

friction,  wind,  and  Coriolis  effects,  i .  c  , 


r 


X 


bottom  friction  wind 
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Co  r io  1  is 
effect 


-  2 Utv  sin«l 


RV  2 

(1.486  h  1/6) 
n 
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—  V  ^  cosil  +  2»u  sin«$ 
h  a 


where 

11  =  Manning  n-value 


O  =  empirical  wind  shear  coefficient 
Vft  =  wind  speed  and  direction 
(-O  =  rate  of  earth's  angular  rotation 

0  =  local  latitude 

1.486  =  conversion  from  metric  to  English  units 

"If  we  multiply  Equations  1  and  2  through  by  h  ,  we  obtain 
the  basic  momentum  equations  which  together  with  the  continuity 
Equation  3  are  used  in  this  model,  i.e.: 
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"Finite  element  equations 

“The  finite  element  is  implemented  in  exactly  identical 
fashion  to  that  described  in  King,  Norton,  and  Orlob  (1973)  with 
the  exception  that  u  and  v  are  primary  variables  and  not  the 
flow  quantities  uh  and  vh  as  used  previously. 


"An  element  coefficient  matrix  and  right-hand  side  vector 
take  the  form: 


K^dA,  /NT^dA,  /NT^fdA 
/NT^dA,  /NT^dA,  /NT^fdA 
/MT^£dA,  /f1T4£dA,  /MT^fdA 


/NT  fu  dA 
JNT  fy  dA 
/NT  f  dA 
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'The  terms  then  take  the  following  form  after  partial  integration 
to  restructure  certain  terms: 
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where  j 

N  =  the  shape  function  representing  velocities 

M  =  the  shape  function  representing  heads 

"The  coefficient  matrix  then  has  the  following  contributions 


/;,T  -g  dA  -  //[(£  ♦  hg  ♦  g  ^^77)N  ♦  (HU  ♦  g  ^)NX 

+  (hv  +  —  — ^)M  +  r.'xT  e  -  N  +  f;  T  e  —  M  }dA 

v  dy  p  y  xx  p  X  y  xy  p  y 
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Note  that  the  surface  integrals  have  been  eliminated  in  this 
statement.  On  the  interior  boundaries,  the  finite  element 
assumption  assumes  that  they  cancel  out.  The  external  boundaries 
do,  however,  generate  values  for  the  integrals  and  they  are 
incorporated  in  the  model."  (Knd  of  quote  from  Norton  and  King 
(  1  9  7  7  )) 


Solution  of  the  Nonlinear  Equations 


9.  The  governing  equations  are  solved  implicitly  in  their 
complete,  nonlinear  form--a  solution  that  requires  a  method  of 
successive  approximations.  Details  of  the  solutions  scheme  for 
this  program  are  presented  in  King,  Norton,  and  Orlob  (1973). 
Briefly,  the  Galerkin  method  of  weighted  residuals  is  used  to 
cast  the  governing  equations  into  a  set  of  simultaneous  equations 
The  Newton-Raphson  iterative  method  of  successive  approximations 
is  then  used  to  solve  the  system  of  simultaneous  equations.  The 
procedure  requires  an  initial  approximation,  called  INITIAL  CON¬ 
DITION,  to  start  the  computations.  Convergence  from  that  first 
estimate  to  the  final  solution  usually  takes  three  to  five  itera¬ 
tions.  The  better  the  first  estimate  approximates  the  solution, 
the  fewer  the  number  of  iterations  required  for  convergence. 

Convergence 

10.  Convergence  of  this  solution  scheme,  like  any  nonlinear 
set  of  equations,  is  not  guaranteed.  In  general,  the  smaller  the 
velocities,  the  more  likely  the  solution  will  converge  in  an  all 
wet  mesh.  Convergence  is  more  of  a  problem  in  partially  wet 
meshes  than  in  all  wet  meshes  because  numerical  shocks  are 
created  each  time  an  element  is  added  to  or  removed  from  the  flow 
field.  Techniques  developed  to  overcome  convergence  problems  are 
presented  in  the  section  on  Preparation  of  Input  Data  in  this 

a  p  p  e  n  d  i  x  . 

11.  The  measure  of  how  well  the  solution  has  converged  is 
printed  after  each  iteration.  The  convergence  parameters  are 
related  to  x-  and  y-velocity  components  and  depth.  The  values 
printed,  the  differences  between  trial  and  computed  values, 
should  approach  zero  with  each  successive  iteration;  when  they  do 
not,  the  solution  is  said  to  diverge,  and  once  divergence  is 
indicated,  the  computations  will  seldom  recover.  A  better 
initial  approximation  is  usually  required. 

17.  The  user  must  decide  if  the  solution  has  converged 
satisfactorily  within  the  specified  number  of  iterations.  An 
average  depth  tolerance  of  0.01  ft  is  used  in  1-D  programs  and  is 
adequate  for  this  program  also.  There  may  be  situations  in  which 
other  tolerances  are  appropriate.  The  key  is  whether  or  not 
significant  changes  occur  in  the  water-surface  elevations  or  the 
x-  and  v- velocities  if  some  other  tolerance  is  accepted. 
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13.  The  maximum  difference  between  trial  and  computed  va¬ 
lues  ot  the  computed  parameters  is  larger  than  the  average  diffe¬ 
rence  values,  and  the  location  of  this  maximum  is  shown  by  node 
number.  If  it  should  occur  in  an  area  of  primary  interest,  the 
user  should  be  sure  the  adopted  convergence  tolerance  does  not 
affect  decisions  based  on  model  results. 

14.  Presently,  there  is  no  equation  in  RMA-2V  that  monitors 
divergence  and  corrects  conditions  to  ensure  convergence.  When 
divergence  occurs,  the  first  recourse  is  to  increase  energy  loss 
coefficients.  However,  the  larger  the  coefficients,  the  more 
likely  the  computations  will  suppress  actual  eddies  that  will 
form  in  the  prototype.  Therefore,  consider  re-forming  the  finite 
element  network  when  excessively  large  turbulent  loss  coeffi¬ 
cients  become  necessary. 

Energy  Transfers 

15.  Three  energy  transfer  computations  are  included  in  the 

governing  equations:  bed  friction,  surface  wind  friction,  and 

turbulence  exchanges  .  Surface  wind  stress  is  rarely  used  since 
2-1)  models  do  not  properly  describe  wind-induced  currents.  Turbu 
lence  exchanges  become  more  dominant  in  s 1 ow- ve 1 oc  i  t y  flow  (like 
reservoirs)  and  when  large  or  numerous  changes  in  flow  direction 
or  magnitude  occur. 

Bed  friction 

lb.  Bed  friction  is  calculated  with  Manning's  equation  and 
the  range  ol  n-values  one  would  use  in  other  numerical,  hydraulic 
models  for  steady  or  unsteady  flow  computations  (e.g.,  HF.C-2  , 
DWOPK.K,  etc.)  are  satisfactory  for  this  program.  Of  course, 
small  adjustments  may  be  required  to  reconstitute  observed  or 
previously  calculated  water-surface  elevations,  but  those  are 
calibration  adjustments  and  the  procedure  for  calibrating  this 
program  is  the  same  t r i a  1 -an d -e r ro r  approach  as  followed  in 
calibrating  other  numerical  models.  Since  bed  friction  docs  not 
have  to  account  tor  composite  cross-sectioned  roughness  as  in 
1-1)  models,  the  values  in  a  2-1)  model  may  differ  somewhat  from 
those  o  t  a  1-1)  model. 

Surface  wind  friction 

17.  Wind  friction  on  the  water  surface  is  an  energy 
component  not  available  in  the  traditional,  1-1)  models  and  not 
generally  used  in  this  program.  The  equation  is  shown  in  the 
governing  equations  of  this  appendix.  Like  bed  iriction,  the 
wind  triction  equation  requires  a  coefficient  for  momentum 
transfer,  and  the  value  ol  that  coefficient  is  not  readily  de¬ 
fined.  It  is  deemphasized  in  TABS -2  because  wind-driven  currents 
•ire  three-dimensional  in  nature  and  wind  setup  can  be  superim¬ 
posed  on  the  final  result  o  t  the  no- w  i  n  d  condition. 
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Turbulence  exchanges 


IS.  Momentum  exchanges  due  to  velocity  gradients  are 
approximated  in  the  governing  equations  by  multiplying  a  turbu¬ 
lent  exchange  coefficient,  (shown  in  the  text  as  the  letter 

"E"),  times  the  second  derivative  of  the  velocity  with  jjespcct  to 
the  x-  and  y -d  i  r e c t  i  o n s  .  The  units  for  K  are  lb-sec/tt  .  The 
progr'm  allows  tor  the  exchange  coefficient  to  be  specified  in  a 
local  coordinate  system  for  each  element.  This  permits  the  user 
to  input  an  exchange  coefficient  for  directions  parallel  to  and 
perpendicular  to  the  direction  of  flow  at  each  element  in  the 
mesh. 


19.  Although  it  is  difficult  to  establish  the  value  for 
E,  analogy  with  physical  conditions  suggests  that  turbulence 
transfers  depend  on  the  momentum  of  the  fluid  and  the  distance  over 
which  that  momentum  applies  divided  by  the  fluid  velocity  and  the 
surface  area  of  the  element.  Therefore,  as  element  size  in¬ 
creases,  E  should  increase,  or  as  the  velocity  increases  E  should 
increase  for  the  turbulent  transfer  rate  to  remain  constant.  Jhat 
is,  multiplying  the  units  of  E  by  ft/ft  yleldjj  ft-lb/£t/sec/ft 
where  the  ft/sec  represents  a  velocity  and  ftz  represents  an  area 
term. 


20.  Turbulence  exchanges  are  sensitive  to  changes  in  the 
direction  of  the  velocity  vector.  Conversely,  small  values  of 
the  turbulent  exchange  coefficients  allow  the  velocity  vectors 
too  much  freedom  to  change  directions  in  the  iterative  solution. 
The  result  is  a  numerically  unstable  problem  for  which  the 
program  will  diverge  rather  than  converge  on  a  solution.  The 
recourse  is  to  continue  increasing  E  until  a  stable  solution  is 
achieved,  then  save  a  HOTSTART  file,  using  the  HOTSTART  file  to 
begin  a  run  with  more  appropriate  values.  Procedures  to  follow  in 
establishing  E  values  are  presented  in  the  section  of  this  appen¬ 
dix  titled  Preparation  of  Input  Data. 


Steady  and  Unsteady  Calculations 

21.  In  their  complete  form,  the  governing  equations  can 
solve  dynamic  problems.  However,  the  finite  element  method  al¬ 
lows  the  time  dependent  terms  to  be  either  turned  on  or  turned 
off  with  input  data.  Consequently,  a  steady-state  solution  can 
be  run  directly,  or  by  simply  addin  g  the  time-dependent  input 
data  the  complete,  unsteady  flow  equations  will  be  solved.  Not 
only  is  that  useful  in  backwater-typo  problems,  but  it  is  also 
useful  for  establishing  initial  conditions  in  an  unsteady  flow 

c  a  1 c  u 1  a  t ion. 

22.  The  unsteady  calculations  advance  in  time  stepwise 
using  an  implicit  solution.  The  time  derivatives  are  replaced  by 
a  nonlinear  finite  difference  approximation  in  which  values  are 
assumed  to  vary  over  each  time  interval  as  follows: 
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f(t)  =  f(o) 


where 


1  ( t ) 

=  value 

a  t 

end  of  time-step 

t  (o) 

=  value 

a  t 

beginning  of  time 

-step 

,  h  ,c 

=  c  o  e  f  1 

icients  assumed  to  be 

constant 

The  coefficients  a,  h,  and  c  were  established  by  numerical 
experiments  and  are  not  input  variables.  The  value  of  c  is  1.5 
(Norton  and  King  1977).  This  nonlinear  time  function  is  extreme¬ 
ly  powerful  in  combination  with  the  implicit  solution.  As  a 
result,  relatively  long  computation  times  are  permissible  (even 
I -hr  time -steps  have  been  succesfully  used  in  an  estuary  where 
the  tidal  range  was  8  it). 


Finite  Element  Implementation 


Element  description 

21.  The  finite  element  model  RMA-2V  accepts  quadrilateral 
and  triangular  isoparametric  elements.  The  elements  are  defined 
by  eight  and  six  node  points,  respectively.  In  each  case  four/ 
three  of  the  nodes  are  placed  at  the  vertices  and  four/three 
nodes  on  the  sides.  The  exact  position  of  the  mid-side  node 
determines  the  curved  shape  of  the  side.  For  straight-sided 
elements,  the  location  is  precisely  at  the  middle  of  the  side. 

For  curved  boundaries,  the  raid-side  node  may  lie  at  a  location 
that  is  not  halfway  between  corners.  Within  an  element,  quadra¬ 
tic  approximations  are  used  to  represent  the  velocities  u  and 
v  and  linear  approximations  are  used  for  the  depth  h  .  Where 
two  elements  join  together  the  functions  are  continuous.  See 
APPENDIX  I):  MESH  GENERATION  for  a  discussion  of  desirable  ele¬ 

ment  characteristics. 

Network  of  elements 

24.  The  proper  finite  element  (FE)  network  is  the  most 
fundamental  aspect  of  successful  finite  element  modeling.  Al¬ 
though  averaging  or  differencing  is  not  involved,  the  finite 
element  shape  functions  distribute  calculated  values  over  the 
element.  Therefore  nodal  points  should  be  carefully  located  to 
capture  changes  of  depth  and  changes  in  energy  gradient  so  that 
these  extremes  are  captured.  Automatic  mesh  generators  (the  mesh 
is  the  set  of  lines,  elements,  and  nodes  in  the  FE  network)  can 
locate  the  (x.y)-coordinates  of  nodes  so  they  best  fit  the  con¬ 
tinuous  surface  requirement  of  the  finite  element  shape  func¬ 
tions;  but  the  automatic  mesh  generators  do  not  consider  the  z- 
coordinate  (the  bed  elevation)  in  that  procedure  nor  do  they  take 
sharp  changes  in  gradients  into  account.  Consequently,  the 
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judgment  of  the  user  is  essential  to  ensure  that  these  factors 
are  incorporated  into  the  network. 

External  boundaries 

25.  The  external  boundary  of  a  network  refers  to  the  lines 
of  nodes  that  have  elements  along  only  one  side  of  them  as  op¬ 
posed  to  internal  lines  of  sides.  Examples  of  external  bounda¬ 
ries  are  the  sides  of  the  network;  the  ends  of  it;  and  islands, 
piers,  or  other  internal  features  that  are  not  overtopped  by  the 
t"  low. 

26.  The  significance  of  external  boundaries  stems  from  the 
2-D  nature  of  the  computations.  That  is,  in  1-D  computations, 
flow  always  travels  parallel  to  the  sides  of  the  numerical  flume 
or  river.  That  is  not  the  case  in  2-D  computations;  and  conse¬ 
quently,  the  calculated  velocity  vectors  can  intersect  the  side- 
wall  of  the  numerical  flume  or  river,  rather  than  be  parallel  to 
it,  just  as  it  does  the  end  boundaries.  The  result  is  a  "leak." 
It  is  necessary  to  identify  all  external  boundaries  using  input 
data  so  RMA-2V  can  avoid  leak  problems. 

27.  An  external  boundary  line  can  be  either  a  straight 
line,  a  sequence  of  straight  line  segments  having  sharp  corners 
where  one  element  joins  another,  or  a  smooth,  quadratic  curve. 

For  the  second  case,  the  velocity  components  at  each  node  must  be 
zero  unless  the  wetting  and  drying  feature  is  turned  on.  When  a 
smooth  (straight  line  or  quadratic  curve)  is  prescribed,  RMA-2V 
will  calculate  its  tangent  at  each  node  and  align  the  velocity 
vector  so  that  flow  is  parallel  to  the  boundary  at  that  point. 
Consequently,  leaks  are  avoided  by  the  proper  specification  of 
boundary  conditions. 

28.  A  wetting  and  drying  feature  allows  the  model  to 

represent  the  process  by  which  shallow  areas  emerge  as  the  water 
level  falls.  This  is  commonly  encountered  in  tidal  flats  and 
river  overbank  areas.  This  feature  should  be  used  only  when  the 
cross-sectional  area  or  surface  area  of  the  flow  changes 
significantly  during  a  flow  event.  The  library  version  of  the 
program  considers  whole  elements  to  be  either  d  r  y  or  v>.  . 

Because  of  numerical  problems  associated  with  very  small  depths, 
elements  are  considered  "dry”  and  removed  from  the  calculation 
when  depths  reach  a  small  critical  value. 

Wetting  and  drying 

29.  Areas  of  the  network  that  become  dry  are  resolved  by 
manipulating  the  individual  elements.  If  any  node  in  an  element 
is  dry,  the  entire  element  is  removed  from  the  computations. 

This  procedure  produces  two  problems:  an  irregular  side  boundary 

having  sharp  corners  rather  than  the  smooth  external  boundary  of 
the  original  network,  and  numerical  shocks  each  time  an  element 
is  added  or  removed.  Logic  in  the  program  aligns  the  boundary 
velocity  vectors  with  the  irregular  boundary  to  prevent  1  e a k s  and 
to  allow  a  slip  flow  along  the  newly  formed  external  boundary. 


* 


Both  Che  velocity  and  its  time  derivatives  at  the  present  and 
past  iteration  are  thus  recalculated.  This  special  treatment  of 
flow  along  a  boundary  applies  only  to  partially  dry  meshes.  It 
is  not  applicable  along  external  boundaries.  The  problem  of 
numerical  shocks  has  not  been  completely  resolved.  By  keeping 
elements  small,  the  shock  can  be  minimized  and  by  increasing  the 
number  of  iterations  between  d r y-no de -che ck s  ,  stability  can  be 
increased.  An  experimental  version  of  the  program  moves  the 
external  boundaries  with  the  water's  edge,  partially  wetting  or 
drying  boundary  elements.  That  version  is  both  more  difficult  to 
use  and  more  expensive  to  run. 


Boundary  Conditions 


30.  There  are  five  ways  that  conditions  can  be  specified  at 

each  node:  no  boundary  condition,  flow  boundary  condition, 

parallel  tlow  boundary  condition  (i.e.,  slip  flow),  corner 
boundary  conditions  (stagnation  point),  and  water-level  boundary 
condition.  The  use  of  no  boundary  condition  allows  the  program 
to  compute  both  velocity  components  and  the  depth  at  that  node. 
The  use  of  any  other  specification  removes  either  the  depth  or 
the  velocity  components  from  the  computations  and  the  program 
expects  those  values  to  be  entered  as  input  data  or  otherwise 
prescribed . 

31.  The  normal  use  of  boundary  conditions  allows  the 
numerical  model  to  resemble  a  flume  in  its  operational  charac¬ 
teristics.  Kxternal  boundary  nodes  along  the  downstream  end  of 
the  network  are  assigned  a  water-level  boundary  condition.  That 
is  like  setting  the  tailgate  on  a  physical  model  to  control  the 
water  depth  at  the  exit.  Boundary  nodes  along  the  upstream  end 
of  the  network  are  assigned  an  exact  flow  or  discharge  boundary 
condition.  V ' ,  ?  t  is  like  setting  the  inflow  valve  on  a  physical 
model  because  it  controls  the  water  discharge  in  the  computa¬ 
tions.  Kach  side  wall  of  the  network  is  assigned  a  parallel 
tlow  (i.e.,  slip  flow)  boundary  condition  which  allows  the 
program  to  calculate  the  velocity  adjacent  and  parallel  to  the 
side  wall  as  well  as  the  tlow  depth  there. 

32.  The  water  level  boundary  condition  allows  the  program 
to  adjust  the  water  depth  as  needed  to  obtain  the  optimum  solu¬ 
tion  of  the  finite  element  equations.  The  minimization  princi¬ 
ples  in  the  solution  technique  reach  optimums  when  all  heads, 
even  those  along  the  exit  boundary,  can  be  adjusted  individually 
to  preserve  overall  network  optimizations.  The  result  is  water 

s  u r I  a  c  e  s  a  t  the  exit  boundary  nodes  that  ri  i  I  fer  slightly  from 
those  -oiled  as  the  boundary  conditions.  If  the  calculated  levels 
v  ,i  r  y  significantly  from  specified  values,  something  is  wrong  with 
the  way  the  problem  is  being  post'd  .  See  PART  V. 

S3.  Normally,  all  interior  nodes  are  left  in  the  computa¬ 
tions  (i.e.,  the  "no  boundary  condition"  option);  however,  one 
attribute  of  the  finite  element  method  is  that  a  water-level  or 
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discharge  condition  can  be  prescribed  anywhere  in  the  network  and 
not  just  along  the  boundaries  or  at  predetermined  nodes.  There¬ 
fore  it  is  possible  to  code  boundary  conditions  at  internal  nodes 
in  the  network.  This  makes  it  possible  to  simulate  structures 
that  are  not  explicitly  represented  by  the  mesh  and  to  construct 
barriers  of  zero  width,  a  very  powerful  technique. 
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35.  No  special  equations  .ire  required  tor  boundary  nodes. 
Where  boundary  conditions  are  prescribed,  those  nodes  are  simply 
left  out  of  the  computation  matrix  and  the  prescribed  values  are 
substituted  in  their  place. 


Iteration  Control 
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’  e r  ge d  , 

1  r  o  t 
network 
t  e  ra¬ 
le  t  o  r  y 
e  s  nlii- 
’  o  t  t  i me  - 
i  d  y  s  o  1  n  - 


If.  I  u  rl  g  e  u  il  s  t  e  a  d  v  - 
achieved  tor  the  steady-1 
o  t  e  x  pe  r  i  me  n  tat  i  o  n  nil  y  hi 
con  v  e  r  g e  n  c e  ,  hut  a  1  i  t  t  1 i 
best  appro  a c h  . 


;  i  a  i  i  in  relation  to  that 
As  before,  a  certain  amount 
'  a  c  h  i  e  v  e  optimum 


i  e c  e  s  s  a  r  v  '  o  a  c  h  l  c  v e  optimum 

’  X  p  e  r  i  e  n  c  e  and  testing  will 
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3K.  When  dry  nodes  are  allowed,  there  is  an  iteration 
control  that  specifies  how  many  iterations  will  be  made  between 
checks  to  determine  which  nodes  are  dry.  This  must  be  assigned 
separately  from  that  for  the  primary  computations. 


Input  and  Output 


i'J.  Four  input  data  files  and  three  output  files  are  avail¬ 
able  in  KMA-2V.  These  are  shown  in  Tables  FI  and  K2.  The  file 
names  are  those  used  as  in  the  instructions  for  the  procedure 
file,  PKOCLV,  which  generates  job  control  and  submits  the  jobs 
(sop  Appendix  0).  The  tables  show  the  standard  (default)  logical 
units  for  the  files.  The  standard  units  may  be  changed  by  input. 

Table  FI 


Input  Files 


P  ROC  I.V 
Name 

Standard  Logical 
Unit  Numbers 

File  Contents 

Source 

Kile  Type 

I  1  K  2 

5 

Card  image  input  for  run 
con  t  ro  1 

K d i tor 

Coded 

l  2  K  2 

5  .  1 

Card  image  input  boundary 
conditions 

Editor 

Coded 

I  1  K  2 

1 

Hots  tart  from  prior  run 

KMA-2V 

binary 

0  1  K  1 

1  4 

Ge  ome  t  r  y  data  file 

GFGF.N 

B i nary 

Table  F2 

Output  Files 

V  KOC1.V 

N  <  »  m  e 

Standard  Logical 
Unit  Numbers 

File  Contents 

Sour c e 

Kile  T y  p e 

OIK,’ 

2  2 

W  a  t  e  r - s  u  r  f  a  c  e  elevations 
and  velocities 

RMA-2V 

B  i  n  a  r  y 

0  2  K  3 

2 

1 1 1 1 1  s  t  a  r  t.  tile 

RM A- 2 V 

Binary 

— 

h 

Line  printer  output 

RMA-2 V 

Co  d  e  d 

/»  (1  , 

mat  u  r  »•  , 

.  Since  tile  inf 

>i  l  ways  check  t  he 

ormnt  ion  tends  to  change  as  the  prog 
”  HKLP"  command  in  P  ROC  l.V  ior  the  la 

rams 

test 

tile  ri'cini  romi'nt  s  . 


41.  The  required  input  files  are  the  Card  Image  Input  Data 
for  Run  Control"  and  the  "Geometry  Input  File."  Instructions  for 
preparing  the  card  image  file  arc  given  in  this  appendix.  The 
geometry  tile  is  produced  by  the  utility  program  GFGtN  and  in¬ 
structions  for  executing  that  code  are  presented  in  Appendix  D, 
Network  Generation. 

42.  Printout  is  automatically  directed  to  the  standard  line 
printer  unit  when  using  PROCLV.  The  output  buffer  is  emptied  so 
all  print  lines  created  by  the  program  appear  in  the  printout. 

Graphics 

43.  No  graphics  are  produced  by  RNA-2V.  Instead,  the 
output  file  is  ready  for  use  by  utility  programs  which  prepare 
vector  plots,  contours,  or  other  output. 
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PART  III:  PROGRAM  USE 


44.  Use  of  the  program  involves  three  processes:  properly 

assessing  the  nature  of  the  problem,  the  dominant  energy  forces, 
and  energy  dissipation  mechanisms;  coding  data  in  the  form  which 
allows  RMA-2V  (o  model  that  problemjand  analyzing  the  results. 
This  document  focuses  on  the  second  of  those  processes,  but  the 
first  and  third  are  probably  the  more  important  so  far  as  model 
realism  is  concerned  (realism  being,  the  accuracy  to  which  the 
model  simulates  the  prototype  processes). 


Geometry 


45.  Tlie  finite  element  mesh  (the  geometry  file  created 
by  GFCKN)  controls  both  lateral  and  vertical  boundaries.  The 
degree  to  which  it  models  lateral  boundaries  can  be  observed  by 
overlaying  the  mesh  on  a  map  or  aerial  mosaic.  The  agreement 
with  vertical  boundaries  is  more  difficult  to  ascertain.  That 
is,  bed  elevations  are  coded  at  each  corner  node,  and  the  program 
constructs  a  bed  plane  in  each  element.  It  is  important  that  the 
elevations  in  that  bed-plane  model  the  true  elevations  of  the  bed 
throughout  the  element.  It  is  difficult  to  visualize  the  2-D 
model  planes,  but  if  elements  are  aligned  along  cross  sections, 
the  F E  bed  can  be  plotted  on  the  cross  section  to  check  bed 
elevations.  Corner  node  elevations  are  connected  by  straight 
lines  in  the  model  geometry. 

46.  An  (x,y)-co ordinate  can  have  only  one  elevation  (i.e., 
elements  cannot  stand  on  their  edge). 


Initial  Conditions 


47.  The  initial  water  surface  elevations  in  the  RMA-2V 
model  is  called  the  INITIAL  CONDITION  water  level.  It  can  be 
prescribed  as  a  level  water  surface  or  the  1I0TSTART  option  can  be 
used  to  prescribe  a  sloping  water  surface. 

48.  The  water  depth  is  calculated  at  each  node  from  the 
initial  water-surface  elevation  and  the  bed  elevation  in  the 
geometry  tile.  It  is  important  that  the  initial  condition  water- 
surface  elevation  be  higher  than  the  model  bed  and  the  depth 
greater  than  critical  depth.  Those  cases  where  the  bottom  slope 
is  substantial  sometimes  go  unnoticed  and  the  initial  water 
surface  is  assigned  at  the  downstream  boundary  when  that  eleva¬ 
tion  is  below  tlie  tied  surface  of  the  upstream  boundary. 

48.  Partially  dry  rneshs  are  permitted,  but  model  start-up 
is  particularly  painful  so  avoid  arbitrarily  causing  a  dry  condi¬ 
tion.  Adopt  the  estimated  average  water  surface  in  the  model  f o r 
the  initial  condition  until  a  better  estimate  is  obvious. 
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50.  The  initial  condition  flow  velocity  is  taken  to  be  zero 
in  coldstart'runs.  In  hotstart  runs,  the  velocities  at  the  end 
of  the  previous  run  are  used  as  the  initial  condition. 

Initial  Conditions  and  Convergence 

51.  Usually,  reservoir  and  estuary  problems  run  with  no 
particular  convergence  problems.  They  usually  have  relatively 
small  gradients  and  large  diffusion  coefficients.  River 
problems,  or  rivers  in  conjunction  with  reservoirs  or  estuaries, 
are  more  likely  to  have  convergence  problems.  When  divergence 
occurs,  the  success  of  the  study  depends  largely  on  the  ingenuity 
of  the  modeler.  The  following  procedure  to  solve  convergence 
problems  has  evolved  through  several  studies. 

o  Increase  turbulent  loss  coefficients  to  1000 

o  Reduce  boundary  condition  velocities  to  4  ft  per  sec 
or  less 

o  Save  the  HOTSTART  file 

52.  If  convergence  is  achieved,  the  HOTSTART  tile  should 
then  be  used  for  the  initial  condition  by  using  the  HOTSTART 
option,  described  in  this  section.  If  the  solution  does  not 
converge,  continue  Increasing  turbulent  loss  coefficients  and/or 
decreasing  the  boundary  velocities  until  convergence  is  achieved. 

53.  Once  a  suitable  HOTSTART  file  is  available,  return 
turbulent  loss  coefficients  and  boundary  velocities  to  the  de¬ 
sired  values  and  rerun  the  job  using  the  HOTSTART  file  as  input. 
If  the  solution  continues  to  diverge,  repeat  the  HOTSTART  proce¬ 
dure  while  "creeping  up"  on  the  desired  values  by  using  as  a 
starting  place  those  which  worked. 

54.  When  start-up  is  difficult,  always  check  the  results 
for  surprises  such  as  peculiar  gradients,  velocity  magnitudes,  or 
velocity  directions. 

55.  Partially  wet  meshes  are  usually  difficult  to  work 
with.  The  above  procedure  may  fail,  in  which  case  the  recourse 
is  to  estimate  which  elements  will  be  dry,  assign  an  element  type 
(IMAT)  ot  zero,  and  reprocess  the  mesh  through  CFGKN.  It  is  not 
necessary  to  construct  curved  boundaries  since  the  RMA-2V  code 
will  ensure  parallel  flow  in  that  case  it  the  wetting  and  drying 
feature  is  turned  on. 

Manning  n-values 

56.  Bed  shear  stress  is  calculated  with  the  Manning  equa¬ 
tion.  Only  bottom  friction  is  included  in  the  c  a  1  cu  l  a  t  i  on  s  ; 
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n-values  can  be  assigned  by  element,  by  element  type,  or  a  con¬ 
stant  value  can  be  assigned  to  the  entire  mesh.  The  value  de¬ 
pends  on  boundary  roughness  and  not  element  size  or  shape.  Only 
one  value  can  be  prescribed  for  an  element  and  that  coefficient 
does  not  vary  in  time,  with  depth  change,  or  with  discharge 
change.  For  some  cases  (e.g.  deep  inner  channels),  a  composite 
roughness  coefficient  reflecting  bank  roughness  should  be  used. 


Turbulence  Coefficients 


57.  Values  for  E  ,  the  turbulence  coefficients,  will 
usually  affect  results  significantly  up  to  some  maximum  value  but 
there  is  very  little  guidance  available  for  establishing  them. 

If  K  is  too  small,  flow  can  change  directions  in  the  model 
without  causing  a  sufficiently  large  momentum  transfer.  On  the 
other  hand,  if  F.  is  too  small,  the  flow  characteristics  will 
approach  that  of  an  inviscid  fluid  or  the  program  may  abort  by 
diverging  rather  than  completing  the  solution.  The  more  likely 
problem  is  to  choose  F. ' s  that  are  too  large. 

58.  In  general  terms,  turbulent  exchange  coefficients 
should  he  proportional  to  water  depth,  flow  speed,  and  element 
size.  Vreugdenhil  (  197  3)  gives  the  following  expression  for 

•  proportionality: 


K  ~ 


6h 

C 


where 


h  =  water  depth 
C  =  Chezy  coefficient 
V  =  flow  speed 

He  warns,  however,  that  this  equation  gives  only  an  order  of 
magnitude  estimate  and  the  needed  value  may  be  considerably 
different.  Note  that  it  does  not  account  for  element  size. 

59.  For  high  values  of  E  ,  the  compulations  are  more 
likely  to  converge  to  a  solution  but  eddies  may  be  diffused  out 
of  existence.  The  velocity  distribution  will  tend  to  diffuse 
laterally  while  showing  tairly  realistic  directions  ot  the  vec¬ 
tors.  The  energy  gradient  will  be  steeper  than  the  prototype 
unless  the  channel  is  a  prismatic  cross  section  on  a  straight 
alignment. 

f>0.  The  Table  F3  shows  values  of  F.  used  in  a  few  prior 
studies  and  in  Norton  and  King  (1977). 
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Table  F3 


Values  of  Turbulent  Exchange  Coefficients 


_ Type  of  Problem _ 

Homogeneous  horizontal  flow  around 
an  island — turbulent  range 

Homogeneous  horizontal  flow  at  a 
confluence  —  turbulent  range 

Dynamic  flow  in  upper  San  Francisco  Bay 

Steady-state  flow  for  thermal  discharge 
to  a  slow  moving  river 

Tidal  flow  in  a  marshy  estuary 

Slow  flow  through  a  shallow  pond 


Values  of  Turbulent 
Exchange  Coefficients 
( Kd  d  y  Viscosity) 
lb-sec/ ft— 


10  -  100 


25  -  100 


250  -  1000 


100  -  1000 


50  -  200 


61.  Turbulence  exchange  coefficients  are  assigned  by  ele¬ 
ment  type,  and  up  to  10  different  types  can  be  established.  Fou 
values  are  needed  for  each  element.  When  all  elements'  sides  ar 
about  the  same  size, all  four  values  arc  the  same. 

62.  The  coefficients  are  direction-dependent,  and  as  long 
as  a  uniform  value  is  used  for  the  entire  mesh,  direction  is  not 
a  problem.  However,  long  and  narrow  elements  will  often  require 
a  sma’ler  E  value  for  the  narrow  dimension  than  lor  the  long 
one.  Rather  than  coding  for  the  x-  and  v -d  i  r e c t  i o u s  ,  it  is 
possible  to  code  for  the  (s,n)  directions  where  s  is  along  a 
streamline  and  n  is  transverse  to  that  direction.  The  an, lie  i 
the  element  is  then  entered  and  the  program  calculates  t.  lor 
the  (x,y)  coordinates  for  each  element. 


Wind  Shear  Stress  Co  e  t  1  i  c  i  e  n  t 


hi.  Shear  stres-  exerted  on  the  water  by  wind  depends  e  t 
input  (.1  a  wind  stress  coefficient.  Bretschn  eider  (1466  )  showei 
a  value  of  2.6K-3.  Wang  (1474)  gave  the  following  equation  lor 
the  wind  . riction  coefficient: 


0.07  ( u , 


where 


J  =  the  trirtion  coefficient 

u  m  =  wind  speed  10  m  above  the  ground  in  metres  per  second 

Wang's  value  is  less  than  Bretschn eider's  for  wind  speeds  up  to 
28  mps.  Thereafter  Wang's  value  will  exceed  Bretschneider's.  No 
value  should  be  accepted  without  justification.  These  are  given 
to  indicate  order  of  magnitude. 


Boundary  Conditions 


84.  Coding  boundary  conditions  (BC)  involves  three  tasks: 
(a)  identitying  external  boundary  nodes,  (b)  selecting  the  type 
of  BC ,  and  (c)  establishing  the  values  of  the  BC.  Both  steady 
and  unsteady  flow  situations  use  the  same  procedure  for  determi¬ 
ning  BC  except  that  timing  data  becomes  important  in  the  unsteady 
flow  problems.  That  is  discussed  in  the  section  Coding  for 
Unsteady  F 1 ow  Computations. 

Identifying  boundary  nodes 

AS.  CKCKN  will  print  a  table  of  all  external  boundary 
nodes,  and  all  ot  these,  both  corner  and  mid-side  nodes,  must  be 
included  in  the  BC  data  set.  It  is  possible  to  specify  BC  at 
internal  nodes,  but  such  a  technique  musL  be  approached  with  some 
experimentation  using,  vector  plots  and  continuity  checks  to  dis¬ 
play  model  performance. 

B o  undary  condition  ty p  e  s 


6b.  Although  several  types  ol  BC  are  possible  at  each  node, 
some  combinations  can  violate  hydraulic  theory  and  must  be 
avoided.  The  program  does  not  diagnose  such  violations;  the  user 
must  specify  the  proper  type.  The  following  combinations  are 
recommended  or,  in  some  cases,  discouraged;  b  ti  t  it  is  good  prac¬ 
tice  to  always  dev i Sc  simple  test  cases  to  ascertain  correct 
model  behavior.  The  user  can  specify  water  level,  discharge, 
velocity,  or  t 1 ow  direction. 

b  7 .  A  g oo  d  combination  o  t  boundary  condition  types  is  a 
head  (water  level)  at  the  downstream  boundary  and  a  discharge  at 
the  upstream.  Ill  ten,  the  Mow  reverses  so  the  concept  of  up¬ 
stream  and  downstream  is  lost;  hut  the  program  will  perform 
equally  well  it  the  head  is  specified  at  the  upstream  boundary 
and  the  discharge  at  the  downstream.  Avoid  prescribing  both  at 
the'  same  boundary,  however.  In  general,  any  1  1  n  w  condition  that 
can  be  created  in  a  I  1  time  o  f  a  l  i  xe  d  slope  by  manipulating  head 
gates  and  t  a i  1 g a t  e  s  is  a  legitimate  combination  of  boundary  types 
in  KM  A- 2  V .  Unsteady  I  1 ow  problems  will  run  with  t  h  e  same  bounda¬ 
ry  condition  types  as  will  the  steady  I  I nw  problems.  Water-level 
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specifications  or  outflow  discharge  specifications  at  constric¬ 
tions  where  velocity  magnitudes  are  high  may  cause  the  solution 
to  diverge. 

6b.  There  are  several  combinations  of  types  to  avoid.  For 
example,  do  not  prescribe  a  head  at  each  end  of  the  network  plus 
a  velocity  or  discharge  at  one  end  or  the  other.  That  over¬ 
specifies  the  hydraulics  of  the  problem.  Do  not  specify  a  velo¬ 
city  and  a  discharge  type  in  the  same  opening.  An  example  of 
under  specification  is  to  request  a  discharge  at  the  upstream  end 
and  a  discharge  at  the  downstream  end  and  no  head  boundary  condi¬ 
tion  at  all.  (Note:  The  IC-Card  is  an  initial  condition,  not  a 
boundary  condition.)  A  5-digit  code  is  used  to  specify  what  type 
of  boundary  condition  is  being  prescribed.  The  code  is  explained 
below.  See  pagragraphs  30-34  for  a  discussion  of  these 
specif  ications . 


Boundary  Condition  Specification  Code 
TYPE  CODE  =  .XXYOO 


Water-level  specification  control 
Flow  specification  control 


Value  of 

XX 

What  Is  Specified 

00 

Flow  is  not  specified 

0  l 

Slip  flow 

1 1 

Velocity 

3  1 

Unit  discharge 

(^x  ^  0) 

1  3 

Unit  discharge 

(  =  0  ) 

Value  of 

What  Ts  Specified 

Water-, ur face  is  not 
speci f  led 

Water-surface  elevation* 


1 19.  Even  when  the  proper  combinations  are  being  used, 

special  handling  is  required  at  the  two  ends  (or  sides)  of  an 
opening  in  the  boundary.  Figure  F2  illustrates  the  types  that 
have  successfully  executed.  The  nodes  located  at  3  and  4  are 
unique  because  these  are  the  limits  of  the  opening— its  width. 
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0  =  corner  nodes 

X  =  mid-side  nodes 

Figure  F2  .  Boundary  openings 

70.  Nodes  I,  2  ,  10,  and  11  can  be  either  stagnation  or 

slip,  type  11000  or  1000,  respectively.  Nodes  4,  5,  6,  7,  and  8 

can  be  type  200,  11000,  or  31000,  which  are  head,  velocity,  and 

discharge,  respectively,  as  required  to  model  the  physics  of  the 
problem.  Nodes  3  and  9  can  be  type  200  when  nodes  4  through  8 
are  coded  as  type  200  but  if  so  the  mesh  will  "leak"  between 
nodes  2  and  3  and  between  9  and  10.  To  avoid  that  leak,  code 
nodes  3  and  9  as  type  11000  and  assign  velocity  (zero  or  finite) 
or  1200  for  head  and  slip  flow.  In  general,  do  not  code  type 
11200  because  that  overspecifies  the  boundary  condition. 

71.  Attempts  have  been  made  to  assign  type  1000  (slip 
condition)  at  node  locations  3  and  9  but  the  solution  failed  to 
converge.  Attempts  to  code  nodes  3  and  9  as  type  31000  (Q- 
boundary  data)  also  sometimes  results  in  failure  to  converge.  1' 
general,  type  110 Of)  specifications  are  preferred  to  type  31000 
because  they  are  more  likely  to  converge  satisfactorily. 

Kstablishing  boundary  values 


72.  The  entire  study  results,  and  decisions  based  on  those 
results,  will  depend  on  the  boundary  values  that  .ire  established 
It  is  essential  for  the  energy  forces  at  the  boundary  to  statis¬ 
tically  represent  the  dominant  energy  in  the  prototype.  However 
the  question  addressed  here  is  not  "How  representative  is  the 
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boundary  condition?,"  but  “How  can  we  distribute  a  total  value 
among  the  many  nodes  along  a  boundary?" 

73.  Some  experimentation  is  usually  required  in  prescribing 
boundary  condition.  A  reasonable  first  estimate  tor  water  sur- 
fac  across  a  river  is  a  horizontal  line.  A  reasonable  first 
estimate  for  a  water  discharge  across  a  river  is  to  proportion 
the  total  flow  by  applying  the  conveyance  portion  of  Manning's 
equation  at  each  node,  allowing  for  wetted  perimeter  along  the 
hanks  . 

S  /  3 

K .  =  1.486  '  D .  '  ’  W . 

x  -  1  1 

n  . 
l 

q.  =  Q  *  (K./Kt) 


W  . 
l 

whe  re 

K  =  conveyance 
n  =  Manning  n-value 
D  =  water  depth  at  the  node 
W  =  width  of  flow  represented  by  node  i 
q  ^  =  flow  per  foot  of  width  at  node  i 
Q  =  total  flow 
subscripts 

i  =  node  i  on  that  boundary  opening 
t  =  total  for  tli at  boundary  opening 

74.  Not  only  must  the  amount  of  flow  be  estimated  tor  each 
node  but  also  the  direction  of  the  velocity  vector  must  be  esti¬ 
mated.  Incorrectly  specified  directions  (relative  values  of  x 
and  y  components)  can  cause  spurious  results  at  some  distance 
into  the  mesh  or  even  nonconvergence.  A  sketch  of  the  stream¬ 
lines  will  aid  in  establishing  the  proper  direction. 

75.  Test  the  boundary  values  by  running  a  steady-state 
condition  and  plotting  the  velocity  vectors  back  on  the  finite 
element  mesh.  When  computations  fail  to  converge,  the  problem 
may  be  due  to  inaccurate  boundary  values.  Check  velocities  and 
depths  at  the  boundary  openings.  Also,  a  velocity  distribution 
that  changes  radically  from  the  boundary  element  to  the  next  lew 
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elements  downstream  indicates  unsuitable  boundary  values.  Modify 
either  magnitude,  directions,  or  both,  based  on  model  results. 

At  the  same  time,  observe  the  velocities  and  depths  in  the 
primary  area  of  interest  to  make  certain  that  the  above  inaccura¬ 
cies  on  boundaries  do  not  significantly  affect  results  there. 


c  i  e  s  on 


7b.  In  reservoirs  and  estuaries,  it  is  more  difficult  to 
establish  distributions  of  head,  flow,  or  velocity  than  it  is  in 
rivers.  Devise  tests  that  let  the  program  aid  in  establishing 
boundary  values.  Locate  boundaries  sufficiently  far  from  the 
area  of  interest  to  minimize  problems  with  boundary  values.  It 
may  be  necessary  to  make  runs  with  the  boundaries  in  different 
locations  to  evaluate  their  effects.  Sec  Appendix  D  for  proper 
location  of  mesh  boundaries. 


HOTSTART 


77.  The  name  given  to  the  technique  of  saving  computed 
results  at  the  end  of  a  run  so  the  run  can  be  resumed  is  called 
IIOTSTAKT.  This  feature  is  available  for  both  steady  and  unsteady 
flow  computations  and  its  use  is  encouraged  for  both.  It  takes 
very  little  computer  resource  since  only  the  results  from  the  last 
iteration  of  the  last  computation  are  saved.  The  advantage  is 
that  a  better  initial  condition  is  prescribed  by  using  the 
HOTSTART  option,  resulting  in  more  rapid  convergence  in  the 
computations . 

78.  The  process  is  activated  by  requesting  a  restart  file 
($L  Card).  That  file  can  then  be  given  a  name  upon  execution  of 
the  job  by  using  PROCLV.  This  run  is  called  the  creation  or  cold- 
start  run. 

79.  The  HOTSTART  file  produced  by  the  coldstart  run  is  used 
in  much  the  same  way  as  it  is  created.  The  $L-Card,  variable 
"NB",  instructs  the  program  to  read  the  HOTSTART  file,  and  that 
file  is  made  available  by  PROCLV. 

80.  In  steady  flow  computations,  the  T  7.  and  TI  cards  are 
the  same  for  ho t s t a r t  i  ng  and  coldstarting.  The  program  keys  on 
the  presence  or  absence  of  the  HOTSTART  logical  unit  number  "NB" 
on  card  $L.  N START  should  be  zero. 

8  1  .  M  B  AN  I) .  NBAND  is  the  logic  control  variable  that  di¬ 
rects  the  program  to  either  skip  to  the  next  time-step  (MBAND  = 

0 )  or  remain  at  the  last  time-step  of  the  previous  run  (MBAND  = 

1)  tor  the  tirst  computations  of  the  HOTSTART  run.  It  is  input 
on  the  'IV.  card. 

82.  Set  MBAND  to  0  for  normal  HOTSTART  runs.  Set  it  to  1  if 
there  is  a  need  to  make  additional  iterations  at  the  final  time 
step  ot  the  prior  run.  This  need  may  arise  from  incomplete  con¬ 
vergence  at  the  end  o 1  the  previous  run. 
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Coding  for  Steady  Flow  Computations 


83.  An  example  of  the  card  image  input  data  coded  for  the 
Yazoo  Backwater  Area  is  shown  in  Part  IV  of  this  appendix.  Table 
F7  summarizes  the  purpose  of  these  data  cards  and  PART  V  con¬ 
tains  coding  instructions  for  each  variable  on  each  card.  The 
suggested  procedure  for  coding  is  to  consider  the  cards  in  this 
example  as  the  required  input  data;  then  start  with  the  title 
cards  and  go  down  the  list  coding  the  variables  to  describe  the 
new  problem.  Do  not  consider  the  values  in  this  example  as 
typical  values. 

84.  Some  cards  are  flagged  as  optional  in  the  coding  in¬ 
structions  (i.e.,  GC  cards),  but  they  request  continuity  computa¬ 
tions  which  wiLl  he  essential  to  the  interpretation  of  results. 
Always  include  GC-Cards. 

85.  Notice  that  timing  data  are  present  (TZ  Card  and 
others).  That  is  recommended  as  a  means  of  referencing  the 
event;  however,  it  is  not  required  for  steady-state,  cold  start 
computations.  DKLT,  TMAX,  NCBC,  or  N'START  should  not  be  coded 
on  the  TZ-card  for  steady- state  runs. 

Coding  for  Unsteady  Flow  Computations 


8b.  Coding  for  unsteady  flow  is  only  a  slight  ex',  mis  Lon  of 
coding  for  steady  flow.  The  key  is  the  timing  information.  New 
terms,  SIMULATION,  liYDROGRAPH,  TIMK  ZERO,  COMPUTATION  TIM  F.  INTER¬ 
VAL,  TMAX,  NSTAKT,  and  NITN  are  discussed  in  this  section.  Exam¬ 
ple  F2  shows  the  card  image  input  used  to  begin  an  unsteady  flow 
computation  from  a  steady  flow  HOTSTART  file. 

Simulation  hvdrograph  and  time  zero 


87.  Timing  is  introduced  when  the  boundary  conditions 
(i.e.,  head,  velocity,  or  discharge)  vary  in  time.  The  concept 
is  that  depicted  by  a  hydrograph  at  a  gage,  as  shown  in  Figure 
F  3  . 


88.  When  the  changes  in  boundary  values  are  introduced  and 
the  RMA-2V  code  allowed  to  run  in  the  dynamic  modi',  changes  at 
all  interior  nodes  are  calculated  and  displayed  as  a  function  of 
time.  The  changes  in  boundary  values  become  the  SIMULATION 
H  Y  I)  ROGR  A  PH  .  The  beginning  of  t  h  e  simulation  is  called  1'IMK  ZERO. 
In  coding  prototype  events,  the  true  date  and  Lime  make  referen¬ 
cing  easier,  so  a  TZ  Card  is  provided  so  the  actual  date  and  time 
corresponding  to  TIME  ZERO  can  be  coded. 

Computation  time  interval  ,  i)T 


89.  Although  the  program  uses  an  implicit  solution  scheme, 
some  e  x  pe  r i me  n  t  a  t i o n  is  usually  required  when  establishing  UT  . 
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Figure  F3.  Simulation  hydrograph 


Start  with  a  value  appropriate  for  1-1)  computations,  and  increase 
DT  to  the  largest  value  that  is  numerically  stable  and  physically 
representative  of  the  problem.  For  example,  1-hr  timesteps  can 
he  used  in  some  tidal  problems,  even  when  amplitude  is  6  to  8  ft, 
with  a  good  reconstitution  of  observed  gage  records  and  current 
patterns.  The  required  time -step  size  may  be  dependent  on  ele¬ 
ment  sizes,  strength  of  flows,  flow  patterns,  and  rate  of  bounda¬ 
ry  condition  change.  Many  tidal  studies  with  this  type  of  model 
employ  30 -min  time-steps  satisfactorily,  but  experimentation 
should  be  used  to  ensure  that  any  time-step  is  appropriate  for  a 
given  p  r  o  b 1 e m . 

90.  Another  factor  to  consider  is  that  the  computation  time 
interval  must  be  constant  for  the  entire  simulation  whereas  the 
physics  ot  the  problem  requires  that  the  maximum,  minimum,  and 
breakpoints  in  the  simulation  hydrograph  fall  on  DT  increments. 
That  is,  computations  are  made  only  at  DT  increments  and  to 
evaluate  the  response  inside  the  study  area  to  changes  in  bounda¬ 
ry  values  requires  knowledge  of  the  significant  breakpoints  in 
the  boundary  hydrograph.  Always  plot  the  simulation  hyd  r  og  r  a  p  li  s 
and  mark  the  DT  intervals  along  the  abscissa.  The  concept  is 
illustrated  in  Figure  F  A  . 

91.  Figure  Kb  shows  two  identical  hydrographs  to  illus¬ 
trate  tiie  dill  or  once  between  coding  to  start  an  unsteady  I  1  ow 
computation  and  coding  to  resume  one  I  ron  a  HOT S T A RT  file. 


Figure  F4  .  Computation  points  on  pn  s  i  « u  i  .1 1  i  o  n 
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(a)  RUN  STARTS  AT  TIME  ZERO  (b)  RUN  RESUMES  AT  TIME  =  1 

K  i,t;ure  K  5  •  T  i  n  i  n  >T,  t  o  r  mist  v  a  <1  y  I  1  ow  i*  a  l  c  u  1  a  t  i  o  n 
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Figure  5A  shows  computations  beginning  at  TIMK  Z  K  K  0  and  ending 
at  T  M  A  X  =  0.75  hr  (TZ  Card).  Figure  5b  depicts  computations 
resuming  at  Time  =  0.75  hr  and  ending  at  1.50  hr.  The  signifi¬ 
cant  parameters  are  shown  below. 

(  a  )  (  b  ) 

TZKRO  0  0 

ivr  0.2  5  0.2  5 

N  C  B  C  1  1 

N START  1  4 

MBANl)  0  0 

N  1  T  I  5  0 

NITN  2  2 


Mod  cl  sp  i  n  -ii  p 

42.  The  unsteady  flow  computation  almost  always  starts  from 
a  "coldstart  ".  That  is,  the  true  velocity  and  depth  field  in  the 
model  are  not  known  and  an  approximation  is  made  just  to  get 
romputut ions  under  way.  The  model  must  simulate  a  long  enough 
period  oi  tine  to  establish  a  condition  like  that  existing  in  the 
prototype  at  time  zero.  The  procedure  is  called  Mode  1 
Spin-up,  and  the  response  is  a  repetition  of  water-surface  eleva¬ 
tions  and  velocities  Iron  one  cycle  of  the  boundary  condition  to 
the  previous  one.  hike  time-step  size,  the  necessary  length  of 

s  p i n -u p  time  will  vary  I  nun  one  problem  to  another.  Unlike  some 

models  that  require  many  hours  of  spin-up,  fully  implicit  models 
spin-up  rapidly,  in  as  tew  as  three  or  four  time-steps  in  many 
cases;  however,  some  physical  situations  where  inertial  forces 
art'  important  in  t  1  o  w  patterns  ( e  .  g  .  large  gyres)  may  require 
longer  spin-up  t  imes. 

4  i  .  no  i  e  s  p i n - u  p  is  achieved,  it  is  customary  to  save  the 

model  result  in  a  tin  r  ST  A  RT  tile  so  that  future  runs  can  skip 

the  spin-up  costs.  However,  the  number  of  repetitions  of  the 
boundary  conditions  required  tor  model  spin-up  is  found  by  e  x - 
p e r i me  n  t  i n g . 

44.  It  is  important  to  make  the  computation  time  interval 
used  lor  model  spin-up  the  same  length  as  that  tor  the  unsteady 
Mow  computations  so  the  time  derivatives  written  to  the  IIOTSTART 


FART  IV:  EXAMPLES  OF  CARO  IMAGE 

INPUT  DATA 


Example  FI:  The  Yazoo  Backwater  Area  Pump  Station, 

Steady  Flow  Case 


95.  The  mesh  tor  the  Yazoo  application  is  shown  in  Figure 
F 6  .  It  has  been  annotated  for  use  in  deseri  binj;  the  card  image 
input  data  that  follow. 

96.  The  problem  under  investigation  was  site  location  for  a 
proposed  pumping  station  in  the  Yazoo  Backwater  Area  near 
Vicksburg,  Mississippi.  The  levee  area  was  drained  by  a 
gravity  flow  structure,  the  Steel  Bayou  Drainage  Structure,  at 
location  I)  on  the  mesh.  Locations  A  and  B  were  inflow  points,  and 
the  proposed  site  for  the  pump  station  is  location  C.  The  levee 
is  not  shown,  but  it  ran  along  the  bottom  of  the  grid.  External 
boundaries  of  the  mesh  followed  the  elevation  80-ft  contour  becaus 
pumping  started  when  the  water  level  exceeded  that  elevation. 

The  question  being,  addressed  was,  "Can  the  proposed  channels 
deliver  the  l  7  ,  0  0 1 )  —  c f s  design  discharge  to  the  pumps?"  A  steady 
flow  test  was  followed  by  an  unsteady  flow  test. 

97.  The  steady-state  input  data  card  images  for  Example  1 
are  shown  in  Figure  F7  .  Notice  that  the  boundary  cards  in  the 
data  listing  ( BC  Cards)  are  grouped  by  ini  low/outflow  point.  It 
is  not  necessary  to  arrange  them  in  sequential  order.  Moreover, 
each  BC  card  will  prescribe  type  and  value  at  two  nodes  which 
splits  the  first  BC  card  in  the  B-boundary  set  between  locations 
A  and  B.  Finally,  boundary  type  31000  is  coded  lor  inflow  points 
A  and  B,  but  two  discharge  components  plus  the  water-surface 
elevation  are  shown  on  the  cards.  That  is  possible  because  the 
program  never  actually  uses  those  water  surfaces  as  boundary 
conditions  since  the  boundary  "type"  controls  the  computations. 

A  water-surface  elevation  (type  200  BC)  was  prescribed  at  hounda- 


r  i  e  s 

card 

D ,  howe  v  e r . 

98. 

The  type  II  Otm  lit; 

cards  1 

i s  t  e  d  aft 

e  r  t  h  e 

!)-  h  o  u  ikI  a  r  y 

data 

set  ; 

specify  s  t  agn  a  t i on 

points 

a t  extern 

a  1  node 

s  i  n  t  fu*  ini'  s  It 

wlu’r  e 

a  smooth,  curved  hound 

ary  rou 

1  d  n  o  t  b  e 

c  s  t  a  h  1 

i  slu’ d  (  a 

stagnation  point  has  u  =  0  and  v  =  0).  The  type  1000  BC  cards 
are  slip  boundary  nodes  ( i . e . ,  smooth,  curved  boundaries). 

Example  F2:  The  Yazoo  Backwater  Area  Pump  Station 

Unsteady  Flow  1  rim  Co  Ids  tart 


99.  The  card  image  input  data  file  for  the  unsteady  I  low 
test  is  s  liown  in  Figure  F8  .  That  file  is  set  u  p  tor  a  ho  t  s  t  a  r  t  . 
Three  points  are  pertinent:  (a)  timing  controls  have  been  added 

to  the  T  7.  Ca  r  d  of  t  li  e  s  t  e.i  d  y  1  1  o  w  data  set;  (  h  )  iteration  control 
has  been  added  to  the  fi  Card;  and  (c)  boundary  condition  data  at 
tile  end  of  computation  time,  steps  1  and  2  have  been  added  to  t  hi 
s  t  e  a  d  v  flow  I  i  1 e  . 
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Example  FI 


T1  YAZOO  BACKWATER  AREA  RMA2  INPUT  FILE 
T3  ALTERNATIVE  NO.  1  EL  85  UPSTREAM  LOW-WATER  GRID 
f L  , , .14.22 
TR.O.O. 1 

GI. 32. . .436 

GC. 9. 804. 805. 802. 785.751 .749.746,743 
GC  740 

GC, 7 ,315, 318. 321. 324, 327. 330, 333 
GC, 12. 1,2, 5,7. 9, 11. 13, 15 
GC  17.19.21.23 

GC. 9, 971, 974, 977, 990, 983, 986, 991 ,993 
GC  994 

GC,  7, 442. 443. 444, 445. 446. 447. 448 

GD.  .275 

TZ.83, 12, 14,120009 
TI  .5 

FT,  20 

HNT  8312. 14120000.1 . .020,2. . 150.3, .050 

EX,  1,50, 50, 2, 50.50, 3, 50, 50 

EY,  1,50, 50, 2, 50, 50, 3, 50, 50 
IC ,  87 

BCN, 83. 12, 14. 120000, 1,1 1000 

BCN  997.31000. .223, , ,2.31000, . 223 

BCN  1002,31000, . 223, . . 5 . 31000, . 223 

BCN  1010,31000, .223, » ,7,31000, .223 

BCN  1014,31000,4.152, . . 9 . 3 1 000 . 5 . 6 4 3 

BCN  1019,31000,10.105., ,11,31000,14.568 

BCN  1024,31000.11.348, , ,13.31000,8.128 

BCN  1029,31000,5.146, , , 1 5 , 3 1 000 . . 21 9 

BCN  1036,31000. .219, . ,17,31000, .219 

BCN  1041,31000. .219,,, 19. 31000,. 219 

BCN  1046,31000. . 219, , , 21 , 31 000 , .21 9 

BCN  1051 . 31000. .219, ,, 23. 11000 

BCN  315. 11000,,,, 1617, 31000, -23. 54. -14. 00, 80. 88 

BCN  318. 31000, -44. 13,-26. 25, 80. 88, 1624, 3 1*0 00, -44, 13, -26. 25, 80. 88 
BCN  321, 31000. -44. 13. -26. 25. 80. 88, 1631, 31000, -44. 13,-26. 25, BO. SB 
BCN  324,31000.-44.13,-26.25,80.88,1638,31000,-44.13,-26.25,80.88 
BCN  327,31000,-44. 13, -26. 25, BO .88, 1645,31000,-44. 13,-26.25,80.88 
BCN  330,31000,-44.13,-26.25,80.88,1652,31000,-23.54,-14.00,80.88 
-BCN  333. 11000, ,,,804, 200,. ,85. 00 
BCN  2552.200. , . 85 . 00 , 805 . 200 , . . 85 . 00 
BCN  2550. 200,., 85. 00, 802. 200.., 85. 00 
BCN  2520.200, , ,85.00,785,200, , ,85.00 
BCN  2456.200, , .85.00,751 ,200., ,85.00 
BCN  2454. 200, ,. 85. 00, 749, 200... 85. 00 
BCN  2450. 200,,. 85. 00, 746, 200,,, 85. 00 
BCN  2446. 200,  ,.85. 00, 743. 200.  .,35^00 
.  BCN  2441. 200. ,.85. 00 ,740. 200. ,,85. 00 
BCN  971 , 1 1000. ,, .2849 , 11000 
BCN  974, 1 1000. .,, 2854 , 11000 
BCN  977, 11000. ,, ,2858, 1 1000 
BCN  980, 1 1000. .. .2862. 11000 
BCN  983. 11000, ,. .2866, 1 1000 
BCN  986. 11000, ,, ,2870. 1 1000 
BCN  991 . 11000, ,, ,2876. 11000 
BCN  993, 11000. ,, .2878, 11000 
BCN  994, 1 1000. ,. ,399, 11000 
BCN  1662. 1 1000, .. .339. 11000 
BCN  393.  1  1000.  ,,,  1613, 1  1000 
BCN  314,11000, ,, ,350,11000 


!■’  i  u  re  K  7 
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Example  F2 


ft  VAZ00  BACKNATER  AREA  RHA2  INPUT  FILE 

TS  ALTERNATIVE  NO.  I  EX  80  UPSTRtAA  lON-WATER  GRID 

•L. 1.2. 14*22 

TR. 0.0.0 

31.32.*  >434 

GC. *.804.803.802. 783 . 751 » ?49» 746, 743 
GC  740 

GC. 7. 3  IS .318. 321. 324. 327. 330. 333 
GC. 12. 1.2. 5*7,9. 11. 13. 13 
GC  17. 19.21.23 

GC.9.971 ,974.977.900.983.906.991 .993 
CC  994 

GC.  7. 442. 443, 444, 443, 4 46, 447, 4 48 
GO, .273 

TZ.03. 12.14,120000. .30,2.00,1.3,0 

TI.0.2 

fT.20 

HNT  0312.14120000.1. .020,2. . 130,3, .030 

EX.  1,30.30,2.30.50.3.30,30 
ET, I , 50,30,2.30.30, 3.30.30 
IC.03 

BCN. 03. 12.14. 120000.1 » 11000 
BCN  99  7.31000. .223. . .2.31000.  .223 
BCN  1002,31000. .223. •• 3, 31000, .223 
BCN  1010.31000. . 223... 7. 3 1000. .223 
•CM  1014,31000,4. 132... 9. 3 1000. 3. 64 3 
BCN  101 9,31000,10. 103. ,,11,31000.14.568 
BCN  1024,31000.11.340,. .13,31000.0. 120 
BCN  1029.31000.3.146.. • 13.31000. .219 
BCN  10  36. 3 1000.. 2 19... I  7. 31 000. .219 
BCN  1041 .31000. .219. . , 19, j 1000. -219 
BCN  1046.31000. .219. ,.21,31000. .219 
BCN  1051 • 31000. .223. . .23, 11000 

BCN  313. 11000. . . . 161 7,31000, -23. 54. -1 4 . 00. 00 . 00 

BCN  310.31OOC. -44. 13.-26.23.00.00,1624,31000,-44.13.-26.25,80.08 
BCN  321  •  31000,-44. 1  3,-26.23,80.80.  I  63 1 .31  000  .  -  44  •  13, '*26.23, 00. 88 
BCN  32*. JICCO. -44.13,-26.23.00.00.1638.31000.-44.13,-26.23,80.88 
BCN  327.31000. •44.13,-26.75,80. 08,1645,31000,-44.13,-26.23,80.80 
BCN  330.31000.-44,13. -26.25.00.80.1652.31000,-23.34,-14.00.80.88 
BCN  <33.11000,, ,.804.11000 

BCN  25 57, 370 00, ,^80.38,005,13000. , .00. 30 

BCN  2550.  1  1000. . .CO. 38,80  2. 1  1 000. . .80. 38 

BCN  7520.11000. , .00. 38. 705 . 1 1 000 . • • 80 . 30 

BCN  2  456- I  1000.. .80- 30.  751 . I  1000. ..00.30 

BCN  7454. 11000. . .80. 30. 749, 1 l 000. . *80.38 

BCn  «■  0.  I  1  300.  .  ,  HO.  33.  M*.  1  1000.  ,.80.30 

BCN  4  4  5.1  1000.  .  .00.  38.  743,  HOOO.  ♦  .00 . 38 

BCN  2441 . 1 1000. .. 90  33. 740.11000 

BCN  9/1.  .’CO.  .  .05. 204V.  200.  .  .83 

BCN  9  '4  .  7  00. • .85. 7H\4. 700. . .05 

BIN  9?.  00. • .85. 2050. COO. ..83 

BCN  980.700. . .85. 7867- 200. . .03 

1CN  983. 700. . ,85.7864. 200. , .05 

BCN  906  •  .’00.  ...85. 7070. 200.  ,  .85 

BIN  99), .-00.  >*.  83,7076,200.  •  -03 

BCN  993. 70*.., 05. 70'0.  ’00. . ,03 

BLN  994 . 700 .. .85 . 399. 1 1000 

BCN  1667. 11000* .. ,339. 1 1000 

BCN  39 3 . 1 l OOQ. . , , l 61 J. 1 1000 

BCN  314. I  1000. ,, .330* I  1000 


BO*  1541 . 1 000, ...  1539, 1000 
BCN  l5JTi 1000. , ■ , 1535. 1000 
BCN  l*.  '*.1300.  ,,.1348,1000 
BCM  15*7. 1000, ,,, 1330. 1000 
BCN  1 357. 1000, ...  1554. 1000 

B 'N  2 117 ■ 1 300 , , , , 2 1 79 , l 000 
BCm  21 74 . ICOO. , , , 2018. 1000 
BCN  1993,  1000. ,,, 1992.  1000 
BCn  1 VvO . i  000  .... i 978 . 1000 
BCN  1  955 • 1 000. , , , i 9^7 , 1 000 
BCN  191 3.  1000, ...  1893. >000 
BCN  1074. 1000. ...  1077, 1000 
BCN  1  4  I  •  1  r.  oo  .  .  .  .  i  840 , 1  000 
BCn  | j?'  •  1C jO, , , . 1022, 1000 
BCN  1  bOV  .  1  000  .  ,  ,  ,  i  79 6  »  1  000 
BCN  1  '0 J. 1000 .,,, i  770 , 1 000 
BCN  1600.1000 

BCN, dj. 12. 14. 173000. 75t .31000. -19.13,-14.00 
BLN  2 <5* . 3 1  GOO , -  1 8 . 1 3, - i 4 . 80 


lfM  -  io.i3.-i4.bo 

'f"  -<-«•>  .OO-  10.  is.- M. 80.  .  M,. 31000. -18. 13.-14.fl0 
BCN.8  3. I . . 1 4 . 1  3  300  0. 7320.31000. -  1 0. 13. - J4 .80 
BCN  2  450,  «8. 13. -14. 80.. 744. 3 1000. -I  8. 13. -I  4. 00 

■  CN. 83. 17. 14, | 40000  »  8 02 . 3 1 000 ,-10.13,-14.80 

BCN  2446.31000. -10. 13,-14.80 

,  f  ND  OF  FILE 


Figure  KM.  KMA-2V  input  tilo  dynamic  run  started  from  HOTSTART 
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100.  The  change  in  boundary  conditions  with  tine  for  the 
dynamic  simulation  is  recorded  on  the  BCN  cards.  The  first  list 
of  BCN  cards  is  the  initial  or  steady-state  boundary  conditions 
in  which  every  node  is  specified.  This  list  must  be  included 
whether  or  not  the  steady-state  conditions  are  to  be  run.  In  the 
next  list  are  the  boundary  conditions  tht  change  during  the 
second  time-step.  Boundary  lists  are  separated  by  time  and  date 
specifications.  The  boundary  condition  lists  continue  through 
the  simulated  time  frame.  This  same  boundary  list  is  used  for 
all  the  dynamic  runs  regardless  of  beginning  or  ending  time  step. 

101.  After  the  last  BC  Card  in  the  data  set  for  time  zero 
15  placed  the  first  BC  Card  for  the  end  of  time-step  1  (the  end 
of  the  first  computation  time  interval).  The  program  will  key  on 
date/time  data  to  detect  the  start  of  each  new  set  (time-step)  of 
BC  cards.  Moreover,  only  the  nodes  where  BC  values  have  changed 
need  to  be  coded,  and  sequence  is  not  important  except  for  easy 
reference  by  the  user.  Figure  F8  illustrates  coding  and  placing 
BC  Cards  in  proper  sequence.  The  first  card  in  each  set  starts 
out 


BCN ,83 , 12,14, 

v 

followed  by  the  time  in  hours,  minutes,  and  seconds  (i.e., 

120000,123000,  and  130000,  respective!- 

102.  Timing  controls  on  the  TZ  Card  show  DT  and  TMAX  to  be 
0.5  and  1.0,  respectively.  That  is,  the  duration  of  the  simula¬ 
tion  hydrograph  is  1.0  hr  and  the  computation  time-step  is  0.5 
hr.  Iteration  control  on  the  TI  card  shows  a  value  of  0  for  the 
initial  solution  and  2  for  each  solution  thereafter  (which  was  computed 
during  the  coldstart  run).  This  instructs  the  program  to  make 
two  dynamic  iterations  through  the  Newton-Kaphson  convergence 
procedure,  which  is  satisfactory  for  this  problem  and  works  for 
most.  However,  some  experimentation  is  required  in  each  study  to 
establish  the  number  of  iterations. 
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PART  V: 


TESTING  PROCEDURES 


10).  Slops  used  in  applying  RMA-2V  for  a  typical  problem 
are  shown  in  Table  2  ot  the  main  body  of  this  report.  That  table 
is  reproduced  here  as  Table  K4  .  Steps  i  through  10  deal  with 
creating  a  computational  mesh.  Steps  11-13  use  initial  runs  of 
RMA-2V  to  complete  debugging  of  the  mesh  by  locating  leaks  and 
oozes.  Step  14  tests  the  capability  of  the  mesh  and  of  the  input 
KMA-2V  parameters  to  handle  the  flows  and  gradients  that  are 
typical  of  the  planned  application. 

104.  A  sample  job  sheet  to  use  in  recording  job  submission 
for  RMA-2V  is  reproduced  at  the  end  of  the  appendix.  Systematic 
use  of  a  logbook  using  this  jobsheet  form  or  one  like  it  is 
strongly  recommended  for  efficient  use  of  the  program. 


Leaks  and  Oozes 


105.  Leaks  are  caused  by  errors  in  the  geometry  file.  If  a 
node  or  element  is  omitted  or  misplaced  in  the  element  connection 
tables,  water  will  flow  out  of  the  mesh  as  if  it  were  an  outflow 
boundary.  These  errors  and  missing  boundary  condition  specifica¬ 
tions  are  detected  by  a  leak  test.  A  leak  test  is  performed  by 
setting  a  horizontal  pool  in  the  model  and  specifying  that  no 
inflow  occurs.  (Specify  elevation  at  tailwater  boundaries  and 
zero  discharge  at  inflow  boundaries.)  The  initial  leak  test 
should  he  performed  with  four  iterations,  steady-state,  and  a 
flat  bottom--all  bed  elevations  at  the  same  value.  If  a  boundary 
node  has  been  left  unspecified,  or  if  an  error  has  been  made  in 
the  element  connection  table,  the  leak  will  be  vividly  portrayed 
by  substantial  velocities  within  the  mesh.  Single  leaks  can  be 
identit  ied  by  examining  standard  printed  output.  The  maximum 
convergence  parameter  will  be  at  or  adjacent  to  the  leak.  Multi¬ 
ple  leaks  are  more  difficult  to  trace  because  they  can  make  the 
entire  mesh  behave  wildly.  In  those  cases,  plots  can  be  used  to 
locate  the  highest  velocity  magnitudes  and  thus  the  leaks.  Seve¬ 
ral  c o r re c t i on-re t e s t  cycles  may  be  needed  to  identify  and  elimi- 
n a  t  e  all  leaks. 

106.  After  the  flat  bottom  leak  test  has  been  successfully 

e x  e  c  u  t  e  J  ,  actual  bed  elevations  should  be  specified  a  t  all  corner 
nodes  and  the  leak  test  repeated.  Usually,  this  test  will  not 
show  any  strong  leaks  hut  may  demonstrate  oozes.  Oozes  are 
caused  by  poorly  tormed  curved  boundaries  and  some  combinations 
of  element  shape  and  depth  change.  They  can  be  identified  by 
persistent  small  currents  that  occur  during  an  otherwise  success¬ 
ful  leak  test.  The  precise  causes  ot  oozes  are  not  often  ob¬ 
vious,  so  the  procedures  for  eliminating  them  are  largely  experi¬ 
mental.  The  t  irst  step  should  be  to  smooth  bed  elevations  and/or 
to  increase  resolution  (more  elements)  in  the  vicinity  of  the 
ooze.  It  element  sizes  change  dramatically  near  .in  ooze,  try 
making  size  changes  between  adjacent  elements  more  gradual. 


Check  curved  element  sides  to  avoid  needle-like  corners 

and  very  tight  curves.  See  Appendix  D:  Network  Generation  for  a 

discussion  of  curved  boundaries. 

Flow  Stability 

107.  After  leaks  and  oozes  have  been  banished  from  the 
model,  test  steady-state  flows  of  about  the  magnitude  to  be  used 
in  production  work.  Run  a  flat  bottom  test  first.  If  the  model 
runs  to  a  stable  condition,  plot  vectors  to  see  if  the  flow 
patterns  appear  reasonable.'  Nonstable  solutions  or  discontinuous 
flow  patterns  indicate  inadequate  resolution  in  the  mesh,  a  poor 
choice  of  boundary  condition  specifications,  or  unsuitable  values 
for  eddy  viscosity  and/or  bottom  roughness.  Some  experimentation 
(for  example,  see  paragraphs  50-59)  is  required  to  solve  such 
problems . 

10K.  As  described  earlier,  the  water  level  (head)  boundary 
condition  specification  of  type  200  may  not  be  exactly  satisfied 
in  the  fully  converged  solution.  Calculated  heads  should  closely 
approximate  (within  0.2  ft)  the  value  specified.  If  they  do  not, 
the  conditions  are  improperly  posed.  The  problem  may  arise  from 
a  houndary  that  is  near  a  flow  obstruction,  in  a  divergence, 
convergence,  or  channel  curve.  If  so,  the  boundary  must  be 
relocated.  Model  results  should  not  be  used  if  large  differences 
between  calculated  and  specified  water  levels  occur. 

Verlf  tcation 

109.  Adjustment  of  parameters  to  verify  the  model  to 
observed  prototype  data  is  a  t r i a  1 -and -e r r o r  process.  Several 
guidelines  should  be  followed. 

Do  not  assume  that  field  data  are  correct. 
Kxamine  them  carefully  to  ensure  reasonableness, 
consistency,  and  absence  of  contamination  by  un¬ 
modeled  processes  (wind,  etc.).  A  suspicious 
attitude  toward  all  field  data  is  essential. 

b.  Change  only  one  model  parameter  (roughness, 

geometry,  etc.)  in  each  run  and  make  careful, 
systematic  notes  of  the  change  and  its  effect  on 
the  results. 

c_ .  When  changing  a  parameter  for  the  first  time, 

change  it  by  more  than  you  feel  is  needed  so  that 
its  effect  is  pronounced  and  the  appropriate 
value  is  bracketed.  For  example,  if  the  first 
test  used  a  Manning's  coefficient  of  (>.020  and 
you  want  to  increase  it,  first  try  0.050,  then 
decide  on  an  intermediate  value. 


In  unsteady  flow  problems,  watch  tor  spin-up  tine. 
Don't  use  results  from  the  spin-up  period. 


Table  F4 


Summary  of  Steps  for  a  Typical  Applications 


H  . 
9  . 
10. 


1  1 


1  2. 
1  1 . 


1  4  . 


I  ■> . 
1  b  . 
1  7  . 


1  8  . 


1  9 

2  0  , 


Prepare  statement  of  purposes  and  end  products  desired, 


Assemble  available  prototype  information  —  charts,  maps, 
flow  measurements,  etc. 


Sketch  mesh  limits  and  element  layout 


Ret  ine  mesh  sketch,  number  nodes  and  elements  (manually  or 
by  AUTONSO),  and  set  up  connection  table. 


K stab] is h  boundary  condition  nodes. 

Identity  nodes  on  curved  boundaries  and  assign  slopes. 


Digitize  manually  developed  mesh  or  region  boundaries  for 
automatic  mesh  generation. 


Kd i t  and  merge  files  for  GFGKN  input. 

Run  GFGKN  or  (EDCRG),  then  edit  slope  error  problems 


Rerun  GFGKN  until  all  major  slope  errors  are  fixed  and 
network  is  reordered  efficiently. 


Create  RMA-2V  run  control  file  for  s t e ad y -s t a t e  ,  flat-bottom 
leak  test  and  run. 


It  mesh  leaks,  correct  problems. 


Install  actual  bed  elevations,  then  rerun  leak  test. 
Correct  leaks  and  oozes. 


Run  steady  flow  tests  with  flat  bottom,  then  repeat  with 
actual  bed  elevations.  Correct  any  problems. 


Run  KMA-2V  verification  tests, 
Run  RMA-2V  base  test. 


Create  ST  U  Oil  run  control  file  with  inerodible  bed  and 
constant  boundary  concentrations.  Run  short  test,  and 
correct  any  problems  that  occur. 


Modify  STUDH  run  control  file  to  show  desired  bed  condition 
and  initial  and  boundary  conditions.  Run  initial  test  and 
correct  any  problems  that  appear. 


Run  S Til  Dll  verification  tests. 
Run  STIIDH  base  tests. 
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Table  F4  (Concluded) 


Revise  computational  mesh  as  needed  for  plan  to  be  tested. 
Run  RMA-2V  plan  tests. 

Produce  graphical  and  tabular  hydrodynamic  results  output. 
Run  ST  II  DU  plan  tests. 

Produce  graphical  and  tabular  sedimentation  results  output 


Report  results. 
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RMA-2V  JOB  SHEET 

JOB  EXECUTED  _  DATE  OF  RUN  _ / _ / _  TIME  OF  RUN  _ 

JOB  PRINTED  _  SUBMITTED  BY  _  SBUS  _ PRI= _ 

*********************  *********** 
PURPOSE : 


h 


******************************** 

INPUT  DATA 

FILES:  CODED  INPUT  =  _  ,  GFCEN  =  _ 

CODE24  =  _  BC  PILE  =  _ 

HOTSTART  =  _ 

ITERATIONS : 

l  2  3  4  5  6  7  8  9  10  11  12  13  14  15  16  17  18  19  20  21  22 


23  24  25  26  27  28  29  30 


BACKGROUND  IMAT  123456789 
CONSTANTS:  EXX 

EX  Y 
EYX 
EYY 
"  N" 

********************************* 


OUTPUT  DATA 

FILES:  RMA-2V  =  HOTSTART  = 


********************************* 
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ADDKNDUM  F- 1  :  CARD  I  MACK  INPUT  DATA  CODING  INSTRUCTIONS 


1.  This  description  of  input  data  is  written  in  the 
language  for  a  standard  eight-column  format  in  which  the  first 
two  columns  are  reserved  for  "Card  Croup"  and  "Data  Type"  alpha- 
characters,  respectively.  These  two  columns  are  considered  to  be 
field  0.  The  rest  of  field  1,  columns  3  through  8,  is  read  in 
several  combinations  of  columns.  The  instructions  use  the  fol¬ 
lowing  syntax:  “ I  , C  x  x “  where  the  " 1 "  refers  to  field  I  ,  " C "  to 
the  column  and  the  “xx"  are  column  numbers. 

2.  01  the  cards  shown  in  the  following  table,  network 
(mesh)  data  are  prepared  by  G  F G  E  N  are  not  usually  input  as  card 
image  data.  The  other  cards  are  prepared  here.  The  sequence  of 
cards  should  be  in  the  order  shown  in  Table  K  —  1  —  1  .  Input  varia¬ 
bles  are  summarized  in  Table  F-l-2. 

3.  Kit  her  free  tield  or  the  standard  eight-column  card 
fields  are  permitted  with  the  default  being  to  free  field.  In 
standard  eight  column  fields,  unneeded  variables  can  be  omitted, 
hut  in  free  field  unneeded  variables  are  depicted  by  commas. 

Card  image  input  is  summarized  in  Table  F  —  1  —  3  following  the  input 
instructions. 


F-  1  -  1 
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Content 


Required 


T  1  -T3 

TITLE  CARDS 

1  + 

SK 

FORMATTED 

DATA  SET 

$L 

INPUT/ OUTPUT  KILE  NUMBERS 

NO 

TR 

TRACE  PRINTOUT  CONTROLS 

NO 

C  1 

GEOMETRY , 

GENERAL  GEOMETRY  PARAMETERS 

YES 

cc 

GEOMETRY, 

CONTINUITY  CHECK  LINES 

NO 

CD 

GEOMETRY , 

DRY  NODE  CAPABILITY 

YES 

GK 

GEOMETRY , 

ELEMENT  CONNECTION  TABLE 

NO 

GT 

GEOMETRY , 

ELEMENT  CONNECTION  TABLE 

IF 

GE  PRESENT 

GV 

GEOMETRY , 

EDDY  VISCOSITY  TENSOR 

IF 

GE  PRESENT 

GN 

GEOMETRY , 

NODAL  POINT  COORDINATES 

I  F 

GE  PRESENT 

GY 

GEOMETRY , 

BOTTOM  ELEVATIONS 

I  F 

G E  PRES E N T 

TZ 

TIMING,  TIME  ZERO 

YES 

r  t 

TIMING,  NUMBER  OF  ITERATIONS  COUNTER 

YES 

FT 

FLUID  PROPERTIES,  TEMPERATURE 

YES 

HN 

HYDRAULICS ,  MANNING  N-VALUES 

YES 

KX 

TURBULENT 

EXCHANGE  GOF.  FF  I  C  I  ENTS  ,  E,  X-PLANE 

Y  E  S 

F.Y 

TURBULENT 

EXCHANGE  COEFFICIENTS,  K,  Y-PLANE 

Y  E  S 

I  C 

INITIAL  CONDITIONS,  WATER-SURFACE  ELEVATION 

Y  E  S 

BC 

BOUNDARY 

CON D I  T  I ONS 

1<C 

HA 

BOUNDARY , 

AZIMUTH  OF  FLOW 

Vc 

(continued) 

*  K  I  T 11  K.  S 

;  B  C  -  C  A  R  D  S 

OK  COMPARABLE  DATA  ON  BA-BT  CARDS 
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Table  K  —  1  —  1  (Concluded) 


C_.i  _ Content _  Regu  i  red 

BS  BOUNDARY,  CURRENT  SPEED  * 

Bd  BOUNDARY,  WATER-SURFACE  ELEVATION  * 

Bl]  BOUNDARY,  U-VELOCITY  * 

BV  BOUNDARY,  V-VELOCITY  * 

BT  BOUNDARY,  TYPE  OF  BOUNDARY  CONDITIONS  * 

BW  BOUNDARY,  SURFACE  WIND  FIELD  NO 
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Table  F-l-2 
Input  Variables 


Variable 

AO 

AZI 

|  CORD 

DSET 

D  S  E  T  D 

1  DELT 

ELEV 

I  BUP 

I 

ICO 
IDT 
I  FILE 

I 

I  MAT 
I  PL  I 

|  IPRT 

I  SET 

; 

i 


_ Description _  Ca  l 

THE  BOTTOM  ELEVATION  OF  EACH  NODE  C' 

THE  AZIMUTH  OF  CURRENT  DIRECTIONS,  BOUNDARY  H 

CONDITION  NODES 

THE  (X.Y)  COORDINATES  OF  THE  NODE  0 

THE  WATER  DEPTH  AT  WHICH  A  WET  NODE  IS  C 

CONSIDERED  TO  BECOME  DRY 

THE  WATER  DEPTH  AT  WHICH  A  DRY  NODE  0 

BECOMES  REWET 

LENGTH  OF  COMPUTATION  TIME-STEP  T 

THE  AVERAGE  INITIAL  WATER-SURFACE  ELEVATION  I 

OVER  THE  MESH 

LOGICAL  UNIT  NUMBER  FOR  DYNAMIC  BOUNDARY  CONDI-  $ 
TIONS  INPUT  TO  RMA-2V 

CARD  GROUP  IDENTIFIER,  ALL  CARDS  /' 

DATA  TYPE  IDENTIFIER,  ALL  CARDS  A 

LOGICAL  UNIT  NUMBER  FOR  C F GEN  GEOMETRIC  DATA  S 

FILE 

THE  ELEMENT  TYPE  (N-VALUE  AND  EDDY  COEFFICIENTS)  C 

SWITCH  TO  CONTROL  PRINTING  OF  RESULTS  AFTER  T 

EACH  ITERATION  IN  RMA-2V 

SWITCH  TO  PRINT  ELEMENT  INPUT  DATA,  INITIAL  T 

CONDITIONS  AND  N-VALUES 

NUMBER  OF  CORNER  NODES  ON  CONTINUITY  LINE  G 

INPUT  SPECIAL  CODING  INFORMATION  (I.E.,  READ  A 

FROM  COLUMN  3  TO  DETECT  IF  DATA  ARE  CODED 
BY  NODE  OR  JUST  A  CONSTANT  FOR  ENTIRE  MESII) 


(continued) 


I 
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V  a  riablc 
ITS  I 

FU) 

L  l 

LINK 
M  BAN  l) 

NB 

N  BX 

NCbC 

N  V  I  X 

N  l  T  I 

N  I  TN 
N  ITNI) 

N  LL 

NOP 
NOPT 

NSTART 
OMKGA 


Tabic  F-l-2  (Continued) 


Description 


Card 


NUMBER  OF  TIME-STKPS  BETWEEN  SUCCESSIVE  TR 

PRINTOUTS 

INPUT  VARIABLE  DATA  ON  EACH  CARD  ARE  READ  INTO  ALL 

THE  FLO  ARRAY  AND  LATER  PLACED  INTO  THE  PROPER 
VARIABLE  NAME  FOR  USE  IN  RMA-2 

THE  NUMBER  OF  ITERATIONS  BETWEEN  CHECKS  FOR  DRY  CD 
NODE 

CORNER  NODE  NUMBERS  FOR  CONTINUITY  CHECK  GC 

FLAG  TO  TELL  PROGRAM  A  RUN  STARTS  IN  THE  MIDDLE  TZ 
OF  CONVERGENCE  ITERATIONS 

LOGICAL  UNIT  NUMBER  FOR  FILE  CONTAINING  INITIAL  $L 
CONDITIONS 

NUMBER  OF  NODES  WITH  BOUNDARY  CONDITIONS  G1 

SPECIFIED 

NUMBER  OF  TIME-STEPS  BETWEEN  BOUNDARY  CONDITION  TZ 
DATA,  DYNAMIC  RUN 

ARRAY  CONTAINING  LOGIC  FLAGS  FOR  BOUNDARY  BC  ,  BA-BH 

CONDITION  DATA  TYPE 

NUMBER  OF  ITERATIONS  FOR  INITIAL  SOLUTION  (OR  TI 

STEADY-STATE  COMPUTATION  ) 

NUMBER  OF  ITERATIONS  FOR  EACH  DYNAMIC  COMPUTATION  TI 

NUMBER  OF  ITERATIONS  BETWEEN  CHECKS  FOR  DRY  GD 

NODES,  DYNAMIC  CASE 

LOGICAL  UNIT  NUMBER  FOR  RMA-2V  TO  WRITE-RESTART  $L 
FILE 

NODAL  POINT-ELEMENT  CONNECTION  TABLE  FOR  RMA-2V  GE 

LOGICAL  UNIT  NUMBER  FOR  RMA-2V  TO  WRITE  RESULTS  $L 

FOR  TRANSFER  TO  STUDH 

STARTING  TIME-STEP  NUMBER  TZ 

LATITUDE  OF  MESH  (APPROXIMATE  AVERAGE)  Cl 


( co  n  t  inued) 


F-  I  -  5 


RMA-2V 


vv  *. 


04/85 


Table  F  —  1  —  2  (Concluded) 


e  Descript  ion 


ORT  K DDK  DIFFUSION  AND  N-VALUE  ARRAY  BY  ELEMENT 

TYPE 

TEMP  AVERAGE  INITIAL  WATER  TEMPERATURE 

SIGMA  SURFACE  WIND  FIELD 

SPEC  ARRAY  CONTAINING  BOUNDARY  CONDITION 
SPECIFICATIONS 

TITLE  TITLE  CARDS  ARE  READ  INTO  ARRAY  TITLE 

Til  AZIMUTH  OF  X-DIRECTION  OF  AN  ELEMENT  FOR 

SPECIFYING  EDDY  DIFFUSION  COEFFICIENTS 


E  X  ,  E  Y  ,  H  N 


BC  ,  BA-BH 


XMANN 


TOTAL  TIME  FOR  SIMULATION 

A  CONSTANT  MANNING  N-VALHE  FOR  RMA-2V  DEFAULT 
LOGIC 


X SCALE  SCALE  FACTOR  FOR  X -COORD I  NAT E S  ( 

YMANN  MANNING  N-VALUE  ASSIGNED  BY  ELEMENT  NUMBER  I 

YSCALE  SCALE  FACTOR  FOR  Y-COO RD 1  NATES  i 

NOTES : 

I  ECHO  -  variable  in  PREHYD  defaults  to  zero  and  will  echo 
print.  A  value  other  than  zero,  no  eclio  print. 

I  WIND  -  variable  In  PREHYD  defaults  to  zero  for  no  wind 

data.  A  value  other  than  zero,  wind  data  are  present. 

YMANN  -  if  no  I1NE  cards  present,  YMANN  is  set  to  0  RT(  I M  AT  (  t.  0  P 
(1,1))  t  0,  otherwise  YMANN  is  set  to  XMANN.  Only 
one  value  ot  YMANN  is  set  for  the  above  conditions. 


mi 


T 1 -T 1  CAR 0  S 


Jon  Til  I  i ' 


On <•  Kf  i|  ii  i  r  ed 


Any  nn  nib  or  of  T1  ami  T2  cards  in  ay  bo  used  and  sequence  is 

not  s  i  i!  n  i  t  i  c  a  n  t  .  Only  one  T3  card  may  be  used,  and  it  must  be 

the  last  title  card  in  t ho  set.  The  program  reads  the  "3"  as 

mean  in,;  KM)  OK  T  CARDS. 

Field  Variable  Value  _ Descript  ion _ 

*0,  Cl  ICC  T 

0  ,  C2  IDT  1,2,3 

1,  C3-H  KCO(l)  Any  Any  alpha-numeric  data 

2-10  rtTLIi  Any  Any  alpha-numeric  data 


SI.  CAKD 


I/O  Data  Logical  Unit  Numbers 


Optional 


Card  image  data  described  in  these  pages  are  read  from  logical  unit 
(LI!)  5  (I. U)  7  and  the  F.CI10  PRINT  is  (LU)  6. 


Field  Variable  Value 


Description 


0,C1  ICC 

0  ,  C  2  I  0  T 

NR 


NT  L 


I  F  I  LK 


NOPT 


I  BUP 


S 

L 


0 


Initial  conditions  for  RMA-2V  will  be  coded 
in  this  data  set. 


1 


Initial  conditions  will  be  read  from  logical 
unit  #1  -  a  HOTSTART  is  requested. 


0  No  HOTSTART  file  will  be  written. 


2  RMA-2V  will  write  a  HOTSTART  file  on  logical 

unit  II  2  . 

0  Geometric  data  and  grid  will  be  coded  in  this 
data  set  and  passed  to  RMA-2V  on  LU  II 5 . 

14  Geometric  data  and  grid  will  be  attached  on 
logical  unit  14  for  RMA-2V. 

0  RMA-2V  will  not  save  results  for  STUDH  or  the 

other  utilities. 

22  KMA-2V  will  write  results  of  hydraulic  calcu¬ 
lations  (x-velocity,  y-velocity,  and  water- 
surface  elevations  on  logical  unit  22. 

The  logical  unit  on  which  dynamic  boundary 
conditions  will  be  input  to  RMA-2V. 

5  Same  file  as  run  control. 

99  Different  file  (LU  99)  from  run  control. 


K-  1  -9 


RMA-2V 
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l 


TK  CARO 


Field 


Variable 


TRACE  Printout  Control 


Val  ue 


Required 


Description 


J\ 


RMA-2V 


Control  for  output  printing: 

Node  and  element  input  data  suppressed 
All  input  data  printed  except  initial  conditions 
Initial  conditions  from  restart 
Manning's  n-value  table 

No.  of  time-steps  between  successive  prints 

0;  all  time-steps  are  printed 

Every  other  time-step 

Every  third  time-step 

Etc. 

Switch  to  control  printing  of  iterations 
All  iterations  printed  during  convergence 
Only  last  iteration  printed 


F- I -10 
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0 1  CARD 

Grid  , 

General 

Geometry  Parameters 

Re  qu i r e d 

Field 

Variable 

V'  a  1  u  e 

Descri ption 

o,  <:  l 

T  CG 

G 

0  .  C  2 

IDT 

1 

2 

OM  KG  A 

o,+ 

Local 

average  latitude  degrees 

3 

XSCALK 

0  ,+ 

Scale 

factor  for  X-coordinates 

.  Default 

4 

YSCALK 

0,+ 

Scale 

factor  for  X-coordinates 

.  Default 

5 

NBX 

+ 

N unbe r 

of  nodes  with  boundary 

conditions 

specified 

6 

AX  I  X 

Azimuth  of  the  positive  direction  of  the 

0  Defaults  to  90  degrees 

+  Enter  azimuth  of  positive  direction  of  x 


in  degrees 


is  1.0 
is  1.0 

x-axis 

axis 


F-l  -1  1 


RMA-2 V 


CC  CARD 


Continuity  Calculation 


Optional 


Flow  continuity  can  be  calculated  at  up  to  nine  linos  across  part 
or  all  of  the  grid.  Prescribe  the  boundary  line  first  since  that  line 
is  used  in  calculating  the  percents  displayed  on  all  subsequent  lines. 
Code  corner  nodes  only.  Code  all  lines  in  the  same  direction;  other¬ 
wise,  sign  changes  will  occur  in  the  printout.  In  general,  code  right 
to  left  when  facing  downstream.  The  first  list  should  be  the  inflow 
boundary  because  it  will  be  assumed  to  100%. 


Field  Variable  Value 


Description 


0,C  1  ICG  G 

0,C  IDT  C 


2  ISET(K)  +  Number  of  values  specified  for  this  set  of 

GC  cards.  Up  to  16  values  may  be  input. 

3-10  L  I N  K  (  K  ,  J  )  +  Corner  node  number,  .  .  .  number.  If 

1  8 

a  continuation  card  is  needed  (>8  numbers 
in  formatted  input;,  start  in  field  1. 


RMA-2V 


F 


-1-12 


*  A  -"V  n _ V  L  A  _  "■  _  A  _  -  ’  .  _  _  A  -*■.  _  '  A 


X 


.1. 


Gl)  CARD 


Grid,  Dry  Node  Capability 


Required 


Field  Variable  Value 


Description 


0 ,  C  1  ICG 

0,  C  2  LOT 

2  DSET 

3  LI 

4  DSETD 

N  I  T  N  D 

DSKTCK 

DVEL 


rr« 


G 

D 

+  Water  depth  below  which  a  node  is  considered 
"dry"  by  RMA-2V  (.275  ft  is  recommended) 

Number  of  iterations  between  checks  for  dry 
nodes  . 

0  0  prevents  dry  node  calculations 

2  Recommended 

+  Water  depth  at  which  a  dry  node  is  con¬ 

sidered  to  become  wet  again  by  RMA-2V. 

(0.4  ft  is  recommended) 

+  No.  of  dynamic  calculation  iterations  to 

use  when  wetting  and  drying  is  turned  on. 

+  Criterion  lor  deciding  when  adequate  con¬ 
vergence  on  depth  has  occurred  and  itera¬ 
tions  can  be  terminated.  (0.5  is  recommended) 

+  Residual  flow  speed  assigned  to  dry  elements. 

(0.2  fps  is  recommended) 


K  -  l  -  1  3 


RMA-2V 


Grid,  Element  Connection  Table 


Optional 


04/85 

GE  CARD 

The  element  connection  table  will  usually  be  provided  by  this  grid 
preprocessor  and  will  reside  on  logical  unit  14.  If  so,  this  card  should 


be 

omitted 

.  Otherwise 

,  code 

the 

Nodal 

Point-Element  Connection  Table. 

F 

i  e  1  d 

Variable 

Val  ue 

Description 

0, 

C  1 

ICG 

G 

0  , 

C  2 

IDT 

K 

2 

J 

+ 

Element 

num be  r 

3 

-10 

N  0  P  (  J  ,  K  ) 

+ 

Up 

to  8 

node  numbers  for  element  J,  listed 

counterclockwise  around  the  element  STARTING 
FROM  ANY  CORNER.  Can  input  NE  number  of 
GE  CARDS. 


RMA-2V 


F  -  1  -  1  4 


c;r  card 

Grid,  Element  Types 

Required  if  GK  card  present 

Field 

Variable 

Value 

Description 

I  ,C  5 66.  7  8  FLO(  L  ) 
2  F  L  D  (  2  ) 


I  MAT ( J ) 


Year  and  month  (i.e.,  830  2  =  1983,  month  it  2) 

Day,  hour,  minute,  and  second  code  a  2-digit 
number  for  each  (i.e.,  01  07  00  00, 

respectively) 

element  number 

Element  type 

Need  as  many  (J,  IMAT(J)  sets)  as  CE  cards 

present.  If  >  4  sets,  use  continuation  cards 

and  start  in  Field  1. 


F- 1 -1 3 


KM A- 2 V 
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GN  CARD  Grid,  Nodal  Point  Coordinates  Required  if 

G  E  or  GY  card  present 

The  coordinate  values  read  are  multiplied  by  the  appropriate  scale 
1  actors,  XSCAl.E  and  SCAI.E  from  Cl -CARD,  and  should  in  the  proper  X-  and 
Y - e  o ordinates  (feet)  after  transformation. 


Field 

Variable 

Value 

Description 

',  C  1 

1  ,  C  2 

I  CG 

I  l)T 

C 

N 

2 

J 

+ 

Node  nun  her 

3 

C0RI)(  J  ,  l  ) 

-,0,+ 

X-coordinate 

4 

C0RD(J  ,2) 

-,(),+ 

Y-coord i nate 

5-10 

Continue  to  fill  card  in  sets  of  (J,  CORD 
(J,l),  C0RD( J  ,  2 ) )  thru  Field  10.  Tt  sets 
>3,  use  continuation  cards  and  start  in 
Field  2.  Leave  Field  1  blank  except  for 

code  GN . 

E-  1  -  1  7 
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GY  Card 

Nodal  Point  Elevation 

Opt i o  n  a  1 

(one  G N  card  is 
is  required  for 

each  GY  card) 

Field 

Variable  Value 

Description 

,  C  7  ,  8 
,  C  7  ,  8 


F  L  D  (  1  ) 

F  L  D  (  1  ) 
F  1. 1)  (  2  ) 


A0(  T  ) 

(!tC  . 


Constant  elevation  for  entire  mesh. 


elevations  by  corner  node.  Mid  side 

values  are  calculated  by  straight  line 
interpolation. 

lilsvat  ions  by  nodal  point. 

Last  2  digits  of  year  for  data  on  this 
card. 

Mo  n  t  (i  number. 

DAY/HoUK/MI  NIJTE/SECOND  as  one  continuous 
value,  2  digits  for  each. 

Node  number. 

Klevation  at  node  1 . 

Continue  coding  (node  number  elevation) 
sets. 

To  continue  on  another  CY  card,  code 

the  number  in  Field  1  and  its  elevation 

in  Field  2  .  .  .  etc. 


RMA-2V 


1-1 -IK 


I'/.  CARD 


Computation  Time 


Required 


Kiel  <i 


0,  l 

<>,C  2 


l 

3 

4 

5 


(> 


7 

8 


9 


I  .) 


Variable  Value 

ICC  T 

I  l)T  V. 


Description 


,  1.17(2) 


>•'  l.  D  (  3  ) 
Kl.n(  4  ) 
V  U)(  3  ) 


!)K  LT 


TM  AX 


NCUC 


N  STAR  T 


M  KANO 


+  Year  of  time  zero  (i.e.,  1  9  K  3  ) 

+  Month  of  time  zero  (Jan  =  n  i  ) 

+  Day  of  time  zero  (i.e.,  01) 

+■  Hour,  minute,  and  second  for  time  zero. 

Code  as  two  dibits  each.  Knd  with  period 
unless  right  justifies. 

+  DT  =  length  of  the  computation  time 

interval  tor  dynamic  run,  hours. 

0  Leave  blank  for  steady-state  conditions. 

+  Kudin;;  time  for  the  dynamic  run  in  hours. 

0  Leave  blank  for  steady-state  conditions 

1  Number  of  computation  time-steps  between 

boundary  condition  values.  (Must  be  1  in 
this  version  of  RMA-2V) 

+  The  number  to  use  when  resuming  a  run. 

RMA-2V  will  skip  down  in  the  boundary 
conditions  file  until  it  reaches  the 
"N ST ART"  set  and  read  those  to  resume 
computations.  For  HOT ST ART  runs,  this 
should  be  equal  to  the  last  time -step  of 
the  prior  run  plus  1. 

0  The  previous  run  time  step. 

0  Initial  run  or  restarting  on  the  first 

iteration  in  the  convergence  scheme. 

1  Restart  at  an  intermediate  iteration  in 

the  convergence  scheme. 


K  -  1  -  1  9 


RMA-2V 


T 1  CARD 

Number  of  Iterations 

Required 

Field 

Variable 

Value 

Description 

Number  of  iterations  for  initial  solution 

Number  of  iterations  for  each  time-step 
after  the  first  one  in  a  dynamic  run 


RMA-2V 


F- 1-20 


FT  Card 


Water  Temperature 


Required 


Field  Variable  _ 1  ue  _ Description _ 

0,1  ICG  F 

0,C  2  IDT  T 

2  TKMP  +  Average  initial  water  temperature  (°C) 


F- 1 -2  1 


RMA-2V 


Y5 
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HN  CARD  Manning  N-Value  Required 

Three  options  are  available  for  coding  n-values  as  explained  below, 


They  key  on 
2  =  a  value 

are  listed 
that  option 

variable  I S I :  Option  1  *  a  constant  value  for  the  entire  grid; 
by  element  type;  or  3  =  a  value  by  element  number.  These  options 
in  the  sequence  which  they  should  be  coded,  and  their  priority  is 

3  overrides  2  and  option  2  overrides  1  upon  execution. 

Field 

Variable 

Value 

Description 

0  ,C  1 

0  ,  C  2 

ICG , IDT 

H 

N 

Card  type  =  hydraulic  parameter 

Data  type  =  n-values 

1  ,C3 

LSI 

Option  1  =  REQUIRED  constant  n-value  for 

entire  grid 

T 

Option  2  =  n-value  prescribed  by  element 
type 

E 

Option  3  =  n-value  prescribed  by  element 
numbe  r 

1  ,C4  ,  5 

FLD(  1  ) 

+ 

Last  row  digits  of  year  for  data  on  t  li  i  s  card 

1  ,C6  ,7 

FLD(  1  ) 

+ 

Month  number  for  data  on  this  card 

2 

FLI)(  2) 

+ 

Code  a  2 -digit  number  for  each  of  the  following 
day,  hour,  minute,  second 

3 

FLI)(  3) 

+ 

As  appropriate  option  suggests,  code 

element  type,  number  of  element,  or  number 
for  the  n-value  (Option  1) 

4 

F  LD( 4  ) 

+ 

Code  the  number 

5 

FLDC5) 

+ 

Code  the  next  element  type  number  or  element 
numbe  r 

6 

FLI)(®  ) 

+ 

Code  the  n-value  corresponding  to  FLD(5) 

RMA-2V 


Continue  coding  sets  of  (type  vs  n)  or 
(element  no.  vs  n).  If  more  than  4  are 
required,  continue  on  an  HN  Card  starting 
in  Field  1 . 


F-l -22 


KX  Card  Turbulent  Exchange  Coefficient,  X-plate  Required 

Turbulent  exchange  coefficients  should  be  coded  by  element  type.  In 
equation  notation  the  value  for  Exx  and  for  K  are  coded  on  this  card. 

Values  for  E  and  E  are  coded  on  the  KY-cards. 
yx  yy 


Field 


Variable  Value 


Description 


0,  1  ICC 

(),C  2  IDT 

.1 


OUT ( J  ,  1  ) 


ORT( J  ,  2  ) 


+  Element  type  number  for  the  set  of  turbulent 
exchange  coefficients 

+  Turbulent  exchange  coefficient  E  =  the 

xx 

2 

x-direction  in  the  x-plane  (lb-sec/ft  ) 

+  Turbulent  exchange  coefficient  E  x  y  =  the 

2  ) 

y-direction  in  the  x-plane  (lb-sec/ft 

+  Continue  to  fill  card  in  sets  of  (J,0RT(J,1) 
0RT(J,2))  thru  field  10.  If  sets  >3,  use 
continuation  cards  and  start  in  field  2. 
Leave  Field  1  blank  except  for  code  EX. 


F-l -23 


RMA-2 V 


EY  CARD 


Turbulent  Exchange  Coefficient,  Y-plane 


Required 


Field 

Variable 

Value 

Description 

0,  l 

ICG 

E 

0  ,C  2 

1 1)T 

Y 

2 

J 

+ 

Identification  number  for  a  set  of  turbulent 
exchange  coefficients 

3 

ORT( J  ,  3  ) 

+ 

Turbulent  exchange  coefficient  E  =  the 

yx 

x-direction  in  the  z-plane  (lb-sec/ft^) 

4 

ORT( J ,4) 

+ 

Turbulent  exchange  coefficient  F.yy  =  the 

y-direction  in  the  z-plane  (lb-sec/ft_) 

5-10 

+ 

Continue  to  fill  card  in  sets  of  (J,0RT(J,3) 
0RT(J,4))  thru  field  10.  1  sets  >3,  use 

continuation  cards  and  start  in  Field  2. 
Leave  Field  1  blank  except  for  code  EZ. 

See  instructions  for  the  F.  and  E 

xx  xy 


RMA-2V 


f-i 


Water-Surface  elevation 


Required 


Variable  Value 


De script  ion 


ICG  I 

1 DT  C 

KI.F.V  +  Average  initial  water-surface  elevation  (ft) 
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BC  CARD  Boundary  Conditions  Optional 

The  three  required  boundary  conditions  (BC)  parameters  can  be  coded 
on  this  card  type:  U-velocity,  V-velocity,  and  head.  In  addition,  a  t  i  v  e  - 

digit  number  that  tells  the  program  the  parameter  type  is  coded  as  well  as 
the  nodal  point  number.  Code  one  BC  set  for  each  boundary  node.  Stack  BCN 
card  after  BC  )S  cards  when  using  more  than  one  option.  Both  corner  and 
mid-side  boundary  nodes  require  boundary  conditions. 


Field 

Variable 

Value 

Description 

0  ,  C 

1 

ICG 

B 

Ca  rd 

group  identifier 

0  ,  c 

2 

IDT 

C 

Data 

type  identifier 

1  ,  C  3 

IS  I 

b 

Use 

the  BC  on  this  card  for  all  boundary  node 

equal  to  or  greater  than  the  one  specified 

FLD( 6 ) 

N 

Sets 

the  BC  at  the  specified  node  number 

1  ,  C4 - 

8 

blank 

2 

YEAR 

+ 

Code 

the  4  digit  year  (i.e.,  1983) 

3 

MNTH 

+ 

Code 

the  2  digit  month  number 

4 

DAY 

+ 

Code 

the  2  digit  day  number 

5 

TIME 

+ 

Code 

hour/ minute/second  as  a  6  digit  value 

(i 

.e. ,  1:30  p.m.  =  133000) 

6 

J 

+ 

Code 

the  node  number  for  the  BC  in  FLDS  7-10 

7 

N  F  I X  (  J  ) 

This 

5  digit  number  tells  RMA-2  what  type  of 

boundary  condition  to  use.  Decoding  zeros 
are  not  required. 


7  C  5  2 


1U00  Slip  boundary  at  this  node. 

0  X-volocitv  will  he  calculated 

l  X  - v  e 1 o  c  i  t  y  is  specified  in  K  L D ( H ) 

3  Nonzero  X-unit  discharge  is  specified  in 

F  L 1)  (  8  ) 


7  C  5  3 


7  C  5  4 


0  Y-velocity  will  be  calculated 

1  Y-velocity  or  Y-unit  discharge  is  specified 

in  FED(9)  (if  the  x-unit  discharge  is  zero, 
a  3  should  be  used) 

0  Water-surface  elevation  will  be  calculated 

l  Water-surface  elevation  is  s perilled  in 

F  L  I)  (  10) 


7  C  5  5 


0  Always 


RMA-2V 


F  -  1  -2b 


B  C  CARD  (Continued) 


04/ 8  3 


Field 

Variable 

Value 

Descript  ion 

7  C  5  6 

0 

Always 

8 

SPKC( J , 1 ) 

-  ,  0  ,  + 

The  x-component  of  velocity  or 
ft/sec  or  ftj/sec/ft 

unit  discharge 

9 

si’i:c(  j  ,  2 ) 

- ,  o  ,  + 

The  y-component  of  velocity  or 
ft/sec  or  ftj/sec/ft 

unit  discharge 

10 

S  P K C (  J  ,  3) 

-,(),+ 

Water-surface  elevations,  ft 

04/85 


BA  CARD  Boundary,  Azimuth  of  Flow  Optional 

Alternatives  to  the  BC-Card  are  sets  of  cards  (BA  -  BS  or  B Q  -  BH) 
or  (BU  -  BV  -  BH)  on  which  the  same  three  boundary  parameters  are  coded 
as  on  the  BC -cards,  hut  they  are  coded  in  alternate  formats  which  may  be 
more  convenient.  The  first  set  allows  an  azimuth  to  he  used  along  with  a 
current  or  discharge  to  establish  the  inflowing  velocity  components:  BA- 

card  =  azimuth  of  the  boundary  velocity  vector;  BS  =  speed  of  the  boundary 
velocity,  and  BH  =  the  water-surface  elevations.  The  BQ-card  can  be  used 
in  place  of  BS.  The  value  of  NFIX  is  determined  by  the  program  based  on 
card  types  present.  The  BA-card  should  precede  the  others  and  azimuths  on 
it  will  be  used  to  calculate  either  velocity  components  or  unit  discharge 
components  until  another  BA-card  is  read.  Only  those  values  which  differ 
from  previous  values  must  be  changed. 


F  i  e  1  d 

Variable 

Vain  e 

Description 

0  ,  C  1 

0  ,C  2 

ICG 

IDT 

B 

A 

Card  group  identifier 

Data  type  identifier 

1  ,  Cl 

IS  I 

b 

The  azimuth  on  this  card  is  for  all  boundary 
nodes  equal  to  or  greater  than  F 1,  U  (  3 )  . 

N 

The  azimuth  is  coded  by  node. 

1 ,C5,6 

YKAR 

+ 

Code  the  last  2  digits  of  the  year  for  this 
data 

1.07,8 

M  NTH 

+ 

Code  the  month  number  (0)  to  12) 

2 

DAY/T1MK 

+ 

Code  the  DAY  /  l'OU  R/ M I  NIITK/ SECOND  as  a  continuous 
8-digit  number 

1 

J  1 

+ 

Node  number  for  azimuth  in  FI.  I)(4) 

4 

AX  I  1 

0  ,+ 

Code  the  azimuth,  in  degrees  and  decimals  of 
a  degree,  of  the  velocity  vector  (or  unit 
discharge  vector).  Grid  orientation  is 
defined  on  the  (J!  -card  . 

5 

.12 

6 

W.  I  2 

(»,+ 

Etc. 

Begin  continuation  BA-card  in  FLD(l) 
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F- 1 -28 


BS-CAR!) 


Boundary  Current  Speed 


Optional 


The  magnitude  of  the  velocity  vector  is  coded  on  this  card  type. 

The  input  data  program  will  convert  BS  data  to  U-  and  V-veLocity  components 
using  the  azimuth  on  the  proceeding  BA-card.  Sign  of  the  component  is  cal¬ 
culated  from  its  azimuth  and  t he  specified  grid  orientation  (Gl-Card).  NF1X 
is  assigned  a  value  of  11x00  at  each  node  having,  a  BS  value  where  the  x  denotes 
.1  value  to  be  assigned  by  presence  of  Bll-card  data. 


Field 

Variable 

Value 

Descript  ion 

0  ,C1 

0  ,C2 

I  CC 

1  l)T 

B 

S 

Card  group  identifier 

Data  type  identifier 

1  ,  C  3 

1S1 

b 

lise  tin?  boundary  condition  (BC)  in  FLD(A)  for 
all  boundary  nodes  equal  to  or  greater  than 

F  L  D (  1) 

N 

The  node  number  is  coded  for  each  BC  value  on 
this  card 

1  ,C5 ,6 

Y  K  A  K 

Code  last  2  dig,  its  of  the  year  for  data  on 
this  card 

l  ,C7  ,K 

MNTH 

Code  2  digit  month  number  (  i  .  e  .  ,  01) 

■ » 

t- 

DAY/TIMK 

Code  DAY/ HOUR/ M IN/SBC  as  a  single  8  digit 
number  (i.e.,  07  10  15  00  for  10:25  a .  r.i . 
on  Day  7 ) 

3 

J  1 

+ 

Node  number 

A 

VVFIC  1 

')  »  + 

Current  speed  in  fps  at  node  Jl.  Sign  will  he 

determined  from  the  azimuth  of  the  vector 

i 

,12 

Next  node 

b 

V  V  K  C  2 

Current  speed  at  node  .12,  fps 

K  t  c  . 

Begin  continuation  card  with  node  number  in 
F  L 1)  (  1  )  . 


V  -  1  -  2  9 


KMA-2V 


'  A 


_  ~W  ^  -  _  ,  „  _  'I  _  -  _  .  _  -  .  - 
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BQ  CARD  Boundary,  Unit  Discharge  Optional 

This  card  type  can  bo  used  instead  of  the  BS-cards.  The  program  will 
assign  NFIX  as  33x0  0  w  lie  re  the  x  denotes  the  values  to  be  assigned  by  BH 
card  data. 


Field 

Variable 

Value 

Description 

0  ,  Cl 

0  ,C2 

I  CC 

IDT 

B 

Q 

Card  group  identifier 

Data  type  identifier 

1  ,  C  3 

l  S  I 

t 

Use  the  unit  discharge  in  FLD(4)  for  all 
boundary  nodes  equal  to  or  greater  than 
FL1)(  3) 

N 

The  node  number  is  coded  for  each  BC  value 

this  card 

1  ,  C  5  ,  6 

YKAR 

+ 

Code  the  last  2  digits  of  the  year  for  data 
this  card 

1  ,C7  ,8 

MNTH 

+ 

Code  the  2  digit  month  number 

2 

DAY/TIMK 

+ 

Code  UAY/llOUR/NINUTF/Sr.CONU  as  a  continuous 
8 -d i g i t  number 

3 

J  1 

+ 

Node  number 

L4 

QUKC1 

(),+ 

The  unit  discharge,  cfs/ft,  at  node  J.  The 

program  will  calculate  QU-  and  qv-  unit 
discharge  vectors  irom  qVFC  by  using  the 
azimuth  on  the  preceding  BA-card.  NFIX 

is  automatically  set  to  3.  The  sign  of  q 
and  QV-  is  calculated  l  rom  azimuth  and  ;;r 
orientat ion. 

5 

J  2 

+ 

Next  boundary  node 

r> 

Q  V  K  C  2 

'),+ 

The  unit  discharge  at  J2 

Begin  continuation  cards  with  node  number 
i  n  F  L 1)  (  1  )  • 

RMA-2V 
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B II -CARD 


Boundary,  Hoad 


Optional 


As  an  alternate  to  BC-Cards,  the  water-surface  elevation 
coded  on  this  BH-Card  type  when  BC-Cards  are  not  being  used, 
assigned  xx200  at  each  node  where  BH  data  exist  with  the  xx's 
values  to  he  assigned  by  BS  ,  BQ  ,  Bi!  ,  or  BV  cards. 


shou Id  be 
NFIX  is 
denoting 


Field 

Variable 

Value 

Description 

0  ,C1 

ICC 

B 

Card 

group  identifier 

0  ,C2 

IDT 

H 

Data 

type  identifier 

1  ,C3 

IS  I 

h 

The 

water  surface  elevation  on  this  card  will 

be  used  for  all  boundary  nodes  equal  to  or 
greater  than  FLI)(3).  (Be  careful  not  to 
over  specify  the  water  surface!) 


1  ,C5,6 

YE  AR 

N 

*• 

The  water  surface  BC  is  coded  by  node 

Code  the  last  2  digits  of  the  year  for  this 

date 

l  ,C7  ,8 

MNTil 

+ 

Code  the  month  number 

> 

DAY/TIME 

+ 

Code  the  day/ hour/minute/second  as  a  single 

3 

J  1 

+ 

8-digit  number  (i.e.,  1:45  a.m.  on  2  Jan 

would  be  02014500) 

Node  number  for  water-surface  elevation  in 

F  L  D  (  4  ) 

4  SPEC(J,3)  - ,  0  ,  +  Water-surface  elevation  in  ft 

5  J  2  +  Etc. 


Begin  continuation  card  with  node  number 
in  FLD(l) 


F  -  1  -  3  1 


R  M  A  -  2  V 
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BU-CARD  Boundary,  U-Velocity  Optional 

Code  the  x-component  of  velocity. 


Field 

Variable 

Value 

Description 

0  ,  Cl 

ICG 

li 

Card  group  identifier 

1)  ,  C2 

I  1)  T 

C 

Data  type  identifier 

1  ,C3 

IS  I 

N 

The  U-velocity  on  this  card  is  for  all 

boundary  nodes  equal  to  or  greater  than 

E  L  D  (  3  ) 

The  U-velocity  is  coded  by  node  number 

1  ,  C  5  ,  b 

YKAK 

+ 

Code  the  last  2  digits  of  the  year  for  this 
data  point 

1  , 07  ,8 

M  N  T  H 

+ 

Code  the  month  number  (01  to  12) 

2 

DAY/ T I MK 

+ 

Code  the  Da  y  /  llou  r  /  M  i  nu  t  e  /  Se  con  d  as  a  continuous 
8 - d  i  g i t  number 

3 

J  1 

+ 

Node  number  for  the  velocity  in  KLD(4) 

4 

s  p  i:  c  ( j  ,  i ) 

-,0,+ 

Code  the  x-component  of  the  velocity.  The 

positive  direction  of  the  x-axis  is  the 
+  U  direction 

5 

J  2 

Etc. 

Begin  continuation  BU  card  with  node  number 
in  FLD(l). 
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BV  CAK1)  Boundary,  V-velocity 

Code  the  Y-component  of  velocity 


Optional 


Field 

Variable 

Value 

Description 

1  ,C1 

ICG 

B 

Card  group  identifier 

l ,  C2 

IDT 

V 

Data  type  identifier 

,C3 

IS  I 

t> 

N 

The  V-velocity  on  this  c.rd  is  for  all 
boundary  nodes  equal  to  or  greater  than 
FLD( 3 ) 

The  V-velocity  is  coded  by  node  number 

»  C  5 , 6 

YEAR 

+ 

Code  the  last  2  digits  of  year  for  this 
data  point 

,C7  ,8 

MNTIl 

Code  month  number  (01  to  12) 

2 

DAY/TIMF. 

+ 

Code  the  Day  / llou r  / Mi nu  t e /  Se cond  as  a 
continuous  8-digit  number 

3 

J  1 

+ 

Node  number  for  the  velocity  in  FLD( 4 ) 

4 

SPEC(J.l) 

-  ,  0  ,+ 

Code  the  Y-component  of  the  velocity.  The 
positive  direction  of  the  Y-axis  is  the 
+V  d  irection 

5 

J  2 

Etc. 

Begin  continuation  BU  card  with  Node  Number 
in  FLD(l). 

BT-CARD 


Boundary  Type 


Optional 


The  RMA-2  program  expects  each  boundary  node  to  have  been  assigned  a 
5-digit  number  specifying  the  type  of  boundary  condition  data  to  be  pre¬ 
scribed.  The  variable  name  is  NFIX.  Suppos  NFIX  =  abcde.  The  "a"  digit 
describes  x-direction  flow  or  velocity;  the  "b"  digit  describes  y-direction 
flow  or  velocity;  the  "  c  ”  digit  describes  head  and  digits  " d “  and  ” e "  are 
not  presently  used  but  must  be  present  for  the  number  to  be  complete. 
Consequently,  d  =  e  =  0.  Leading  zeros  are  not  required.  Only  use  BT  card 
to  override  the  NFIX  determined  by  the  Program;  consequently,  it  should  be 
last  in  the  B-card  Group  sets. 


Field  Variable  Value  _ Description 


0  ,C1 

ICG 

IDT 

B 

T 

Card  group  identifier 

Data  type  identifier 

1  ,  C3 

1SI 

t 

N 

Assign  the  NFIX  value  of  FLD(A)  to  alL 
boundary  nodes 

Assign  the  NFIX  value  by  node  number 

1 ,C5 ,6 

YEAR 

+ 

Code  the  last  2  digits  of  the  year  for  this 
data  point 

1 ,C7  ,8 

MNTH 

+ 

Code  the  month  number  (01  to  12) 

2 

DAY/TIME 

+ 

Code  the  Day/Hour/Minute/ Second  as  a 
continuous  8-digit  number 

3 

J1 

+ 

Node  number  for  the  NFIX  in  FLD(A) 

A 

N F IX (  I  ) 

abcde 

This  5-digit  number  is  read  as  a  real  number 
and  partitioned  into  5  parts 

1000 

Denotes  a  slip  boundary  in  either  direction 

a=  1 
=  3 

The  U-velocity  will  be  prescribed 

The  unit  discharge  component  in  the 
X-direction  will  be  prescribed 

0 

The  U-velocity  will  be  calculated 

b=  1 

The  V -velocity  will  be  prescribed 

b  =  3 

The  unit  discharge  component  in  the 
Y-direction  will  he  prescribed 

0 

The  V-velocity  will  be  calculated 

c  =  2 

The  head  (i.e.,  water  surface  elevation)  will 
be  prescribed 

=  0 

d  =  0 
e  =  0 

The  lie  ad  will  bo  calculated 

Required 

Re  qu i red 

RMA-2V 

F  -  1  - 

34 

BW-CARD 


Wind  Velocity 


Opt i ona  1 


Field 


Variable 

Value 

Description 

ICC 

B 

Card  group  identifier 

IDT 

U 

Data  type  identifier 

1SI 

b 

The  wind  data  in  fields  6  and  7  of  this 
will  be  used  at  all  nodes  equal  to  or 
greater  than  J 1 . 

N 

Wind  data  are  coded  by  name 

FLD( 2) 

+ 

Year 

FLD( 3) 

+ 

Month 

FLD( 4) 

+ 

Day,  hour,  minute,  and  second 

J1 

+ 

Node  number 

S I  CM A( J  ,  1  ) 

Wind  velocity  (miles/hour) 

SICMA(J,2)  Azimuth  of  wind  vector  in  degrees 

+  Continue  to  fill  card  in  sets  of  ( J , S 1GMA( J , 1 ) 

S I  CM A( J  ,  2 ) )  thru  Field  10.  If  >2  sets,  use 
continuation  BW-card  with  J  starting  in 
FLI)(  2  )  . 


F  -  1  -  3  5 


RMA-2 V 
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PREFACE 


The  program  described  herein  was  developed  over  the  period 
1972-1982  at  several  institutions  under  funding  from  a  number  of 
sources.  The  version  described  herein  and  preparation  of  this 
user's  manual  was  performed  at  the  US  Army  Engineer  Waterways 
Experiment  Station  (WES)  with  funding  provided  by  the  Office, 
Chief  of  Engineers  (OCE),  US  Army,  under  the  Improvement  of 
Operations  and  Maintenance  Techniques  (IOMT)  research  program. 

Original  program  development  was  performed  by  Dr.  Ranjan 
Ariathurai  under  the  direction  of  Dr.  R.  B.  Krone  at  the  Univer¬ 
sity  of  California,  Davis  (UCD).  It  was  extended  by  Drs. 
Ariathurai,  Krone,  and  R.  C.  MacArthur  at  UCD  with  funding  pro¬ 
vided  by  the  US  Army  Engineer  Dredged  Material  Research  Program. 
The  result  of  that  effort  was  program  SEDIMENT  II.  Enhant  ements 
were  subsequently  made  by  Dr.  Ariathurai  while  working  at  Nielson 
Engineering  and  Research,  Inc.,  under  contract  to  WES.  Funds 
were  provided  by  the  US  Army  Engineer  District,  Portland.  Major 
revisions  to  the  program  were  performed  by  personnel  of  WES  (in 
consultation  with  Dr.  Ariathurai)  with  funds  from  the  OCE  re¬ 
search  program,  IOMT.  During  the  latter  stages  of  program  de¬ 
velopment,  Dr.  Ariathurai  developed  new  versions  of  SEDIMENT  II 
called  SEDIMENT  A 11  and  SEDIMENT  Ml. MET,  also  funded  by  the  IOMT 
program.  Some  of  the  features  of  those  programs  were  then 
adapted  for  use  in  STUPH  hv  WES  personnel. 

Personnel  of  the  WES  Hydraulics  Laboratory  performed  their 
portion  of  program  development  under  the  direction  of  Messrs. 

H.  B.  Simmons  and  F.  A.  Herrmann,  Jr.,  former  and  present  Chiefs 
of  the  Hydraulics  Laboratory;  M.  B.  Boyd,  Chief  of  the  Hydraulics 
Analysis  Division;  R.  A.  Sager,  Chief  of  the  Estuaries  Division, 
G.  M.  Fisackerly,  Chief  of  the  Harbor  Entrance  Branch,  and  E.  C. 
McNair,  Chief  of  the  Sedimentation  Branch.  Mr.  W.  A.  Thomas 
designed  the  program  structure,  wrote  much  of  the  code,  and 
supervised  program  development.  Additional  coding  was  performed 
by  Messrs.  W.  H.  McAnally,  Jr.,  and  S.  A.  Adamec,  Jr.  Other  WES 
personnel  participating  in  coding  and  testing  were  C.  B.  Berger, 
B.P.  Donnell,  J.  D.  Ethridge,  Jr.,  J.  V.  Letter,  Jr.,  and  R.  D. 
Schneider.  Messrs.  Thomas,  McAnally,  and  Adamec  prepared  this 
report  . 

Commanders  and  Directors  of  WES  during  preparation  of  this 
report  were  COL  Nelson  P.  Conover,  CE,  COL  Tiltord  J.  Creel,  CE, 
and  COL  Robert  C.  Lee,  CE.  Technical  Director  was  Ml.  F.  R. 

Brown . 
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A  USER'S  MANUAL  KOR  THE  GENERALIZED  COMPUTER  PROGRAM, 
SEDIMENT  TRANSPORT  IN  UNSTEADY,  2 - U I M E N S 1 0 N A L  FLOW, 
HORIZONTAL  PLANE 

STUDH 

Version  3.3 


PART  I:  INTRODUCTION 


Purp o  s  e 


1.  This  report  describes  use  of  the  generalized  computer 
program  (model).  Sediment  Transport  in  Unsteady,  2-Dimensional 
Flow,  Horizontal  Plane  (STUDH)  Version  3.3,  dated  December  1983. 
The  program  STUDH  is  used  to  compute  transport,  deposition,  and 
erosion  of  sediments  in  two-dimensional  (2-D)  open  channel  flows. 


Origin 


2.  The  initial  program  development  was  accomplished  bv  Dr. 
Ranjan  Ariathurai  (1974)  in  partial  fulfillment  oi  the  require¬ 
ments  for  his  Doctor  oi  Philosophy  degree  at  the  University  of 
California,  Davis.  That  work,  a  2-D  model  in  the  horizontal 
plane,  was  extended  to  include  the  vertical  plain  bv  Ariathurai, 
MacArthur,  and  Krone  (  I  u  7  7  )  under  contract  with  the  US  Army  Corps 
of  Engineers,  Dredged  Material  Research  Program.  Dr.  Ariathurai 
consulted  with  Waterways  Experiment  -•  t  <  o  n  (WES)  personnel 
duringthe  early  testing  phases  ot  the  program  during  which  time 
he  made  several  enhancements  t n  the  program. 


3.  Starting  with  that  basic  work,  \ 
Ariathurai  produced  the  code  described  in 
Ariathurai  subsequently  developed  s  e  v  e i a  1 
models  with  funding  from  WHS.  Selected  t 
have  been  adopted  and  placed  n  to  is  nodi 


basic  work,  WES  personnel  and  Dr. 

described  in  this  m  a n  u  a  1 .  Dr. 

1 o pe d  s  e v  e  r  a  1  new  v  ■  rstnns  of  the 
1 .  Selected  features  -I  those  mo  d  e  .  s 


Potential  A  p  ; ■  I  i  ii.lt  im 


4.  STUDH  can  be  applied  t 
where  flow  velocities  can  he 
direction  can  be  s  a  t  i  s  t  a  c  t  o  r  i  : 
velocity.  It  is  useful  tor  hot 
and,  to  a  limited  extent,  tor  , 


a  "  l  he  d  s  e  d  i  i  e  r.  t  s 
.  c .  ,  the  speed  and 
;  d  e  p  t  h  -  a  v  e  r  a  g  e  d 
d  c  ii s  l  on  s  t  u  d  i  e  s 
ins.  I  h  e  program 


treats  two  categories  of  sediment — noncohesive,  which  is  referred 
to  as  sand  here,  and  cohesive,  which  is  referred  to  as  clay. 


Limitations 


5.  Both  clay  and  sand  may  be  analyzed,  but  the  model  consi¬ 
ders  a  single,  effective  grain  size  for  each  and  treats  each 
separately.  Fall  velocity  must  be  prescribed  along  with  the 
water-surface  elevations,  x-velocity,  y-velocity,  diffusion  coef¬ 
ficients  bed  density,  critical  shear  stresses  for  erosion,  ero¬ 
sion  rate  constants,  and  critical  shear  stress  for  deposition. 

6.  Studies  cannot  utilize  long  simulation  periods  because 
ot  their  computation  cost.  Study  areas  should  be  made  as  small 
as  possible  to  avoid  an  excessive  number  of  elements  when  dynamic 
runs  are  contemplated.  The  same  computation  time  interval  must 
be  satisfactory  for  both  the  transverse  and  longitudinal  flow 
directions. 

7.  The  program  does  not  compute  water  surface  elevations  or 
velocities;  therefore  these  data  must  be  provided.  For  compli¬ 
cated  geometries,  a  numerical  model  for  hydrodynamic  computa¬ 
tions.  RMA-2V.  is  used. 
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PART  11:  PROGRAM  DESIGN 


Capability  of  the  Program 

8.  Either  steady-state  or  transient  flow  problems  can  be 
analyzed.  The  exchange  of  material  with  the  bed  can  be  calcu¬ 
lated  or  suppressed.  The  computation  mesh  can  be  created  by  the 
program  or  it  can  be  created  separately  (Appendix  D)  and  read  in. 
Default  values  may  be  used  tor  many  sediment  characteristics  or 
these  values  may  be  prescribed  by  input  data.  Either  the  smooth 
wall  velocity  profile  or  the  Manning's  equation  may  be  used  to 
calculate  bed  shear  stress  due  to  currents.  Shear  stresses  for 
combined  currents  and  wind  waves  m  a  v  lie  calculated.  The  program 
can  perform  an  internal  extrapolation  that  produces  longer  period 
simulations  at  lower  cost. 


C  o  n c e p  t  n  a  1  Basis 


9.  The  program  is  based  on  the  f-,i  lniiii;,;  conceptual  model: 

£ .  Basic  processes  in  sedimentation  can  be  grouped  into 
erosion, e  n  train  me  r.L, transportation, and  deposition. 

b .  Flowing  water  has  the  potential  to  erode, entrain, 
and  transport  sod  I  me"t  w  h  c  t  h  e  i  ornot  sediment 
particles  are  present. 

C_.  Sediment  on  the  s  L  r  e  ■  m  b  e  d  w  M  I  remain  immobile  only 
aslongasthe  energy  forces  in  theflowfield 
retain  less  t  haiit  hoc  r  it  i  r,i  !  s  lif  ars  t  rests 
threshold  for  erosion. 

<K  Even  when  sand  particles  become  mobile  .there  may 
beno  net  change  in  t  h  s  u  r  t  a  <•  e  elevation  o  f  t  h  e 
bed.  A  net  change  would  result  only  it  the  rate 
of  erosion  was  d  i  t  f  c  rent  ‘  rum  the  rate  o 1 
deposition — two  processes  which  g”  mi  continuously 
and  independently. 

e  .  Co  h  p  s  i  v  e  s  e  d  i  m  e  p,  t  s  i  o  transport  w  1  I  1  r  e  m  a  i  n  t  n 

suspension  as  long  as  i:  bed  shea  r  stress  exceeds 

thecritical  value  tor  ■'  e  p .a  ■  :  t  i  o  n  .  1  n  g  ener  a  1  , 

s  i  it  n  I  tan  v  o  u  sd  e  posit  to  n  a  >,  !  ,  r  ■>  ■  i  o  nuiroheslvo 

sediments  do  not  rnaan  . 

f  .  The  s  t  r  n  c  t  ii  r  imi  f  Cohesive  sediment  h  e  d  s  c  h  a  n  g  e  s 
with  t  i  me  ;i  ml  o  v  *  r  h  u  r  i*  .•  n  . 
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The  major  portio  of  sediment  in  transport  can  be 
characterized  as  being  transported  in  suspension, 
even  that  part  of  the  total  load  that  is 
transported  close  to  the  bed. 


Theoretical  Basis 


10.  The  derivation  of  the  basic  finite  element  formulation 
is  presented  in  Ariathurai  (1974)  and  Ariathurai  ,  MacArthur,  and 
Krone  (1977)  and  summarized  below.  There  are  four  major  computa¬ 
tions. 

o  Suspended  sediment  concentration  using 
the  convection-diffusion  equation  with 
a  bed  source  term 

o  Bed  shear  stress 

o  Bed  source  quantity 

o  Bed  model 

Convection-diffusion  equation 

11.  The  basic  convection-diffusion  equation  is  presented  in 
Ariathurai,  MacArthur,  and  Krone  (1977), 


3C 

3t 


+ 


u 


3C  3C  _  a_ 
3x  V  3y  3x 


+ 


whe  re 


C  =  concentration,  kg/m^ 
t  =  time,  sec 

u  =  flow  velocity  in  x-ditection  ,  m/sec 
x  =  primary  flow  direction,  m 
v  =  flow  velocity  in  y-direction,  m/sec 
y  =  direction  perpendicular  to  x  ,  m 


(Gl) 


Ux  =  effective  diffusion  coefficient  in  x-direction, 
■’/sec 

=  effective  diffusion  coefficient  in  y-directlon, 
m^/sec 
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°^1  =  a  coefficient  for  the  source  ten,  1/sec 

2  =  the  equilibrium  concentration  portion  of  the 
source  term,  kg/m^/sec 

This  equation  is  then  cast  into  the  finite  element  for*  using 
quadratic  shape  functions,  N  , 


NE  ^ 

.  ne  - 
ne=I 


3N.  ar  3N .  ar1 

+  n  —  +  — 1  D  ®P- 
3x  x  3x  3  y  uy  3  y 


NL 


dx  d> 


where 

NE  =  total  number  of  elements 
N  =  the  quadratic  shape  functions 


*£  /V.  t  =  0 

i  =  l 


Q  =  OC/3t)  +  ot2  for  the  transient  problem 

A 

C  =*  the  approximate  concentration  in  an  element  as 

evaluated  from  shape  functions  and  nodal  point 
values  of  c 


$ 


total  number  of  boundary  segments 
the  local  c  .-r.-linate 


*1?  =  flux  from  source  on  boundary  i 
The  transient  equation  is  expressed  as 


(G2) 


m  +  |K|{C}{F}  =  0  (G3) 

where  each  element  in  the  computation  mesh  contributes  the 
following  terms  to  the  global  matrix 
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(T]  -  //d(NJ  [NJ  dx  d y 

|K|  =  J'/D[Kj{u  S  *  's* 


u  li  +  v  ^  -  v} 


3N  ;  3N . 
+  Dx  §i  +  df 


Dy  l|]  dx  dX 

(the  steady  state  system  coefficient  matrix) 


{Fj  = 


-//  (N]T{a0}  dx  dy  +  f  fN)T{q)  d£ 


D 


(the  steady-state  system  coefficient  matrix) 


12.  Applying  the  Cr a n k - N 1 c h o 1 s o n  scheme,  where  0  is  th 
implicitness  coefficient,  gives  the  following  equation,  where  n 
refers  to  the  present,  n+ 1  to  the  future  time-step,  and  t  the 
computation  time  interval. 


{  +  e[K]n+1j  {C}n+1  =  j  m  .  (1  .  e) [k] n|  (C}n 

+  0{F}n+1  +  (1  -  0){F}n 

Bed  shear  stress 


13.  Several  options  are  available  for  computing  bed  shear 
stresses  using 


Tb  =  pu|  (  G  5  ) 

where 

P  =  water  density 
u*  =  shear  velocity 

<i.  Smooth-wall  log  velocity  profile, 

UZ  =  5.75  log  [3.32  (G6) 

which  is  applicable  to  the  lower 
15  percent  of  the  boundary  layer 
when 


u.,.D 

—  >  30 

V 


(G7  ) 


whe  re 

u  =  mean  flow  velocity 
D  “  water  depth 

V  -  kinematic  viscosity  of  water 
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The  Manning  shear  stress  equation, 

Vgij 


u_,_  = 


CME  D 


an 

1/6 


(  G8  ) 


where 


g  =  acceleration  due  to  gravity 
n  =  Manning's  roughness  value 


CME 


coefficient  of  1  for  metric  units 
and  1.486  for  English  units 


A  Jonsson-type  equation  for  surface  shear  stress 
(plane  beds)  caused  by  waves  and  currents. 


Uo. 


1  /fwUom  +_fc^V-  +  %>\ 

*  \  2  \  Uom  +  U  A  2  / 


(C9) 


where 


w  =  shear  stress  coefficient  for  waves 
uom  “  maximum  orbital  velocity  of  waves 


f . 


sh’»r  stress  coefficient  for  currents 


<1.  A  Bijker-type  equation  for  total  shear  stress 
caused  by  waves  and  currents. 


1  ,  -2  7  1  ,  " 

U.,.  =  ofu  +  rfu 

*  ^  2  c  4  w 


2 

om 


(G10) 


For  further  information  on  the  shear  stress  computation  equa¬ 
tions,  see  McAnally  and  Thomas  (1980). 


14.  At  each  time-step,  the  velocity  field  is  recalculated 
to  reflect  the  effect  of  depth  changes.  The  input  velocity 
magnitude  at  each  node  is  multiplied  by  the  ratio  of  the  initial 
water  depth  to  new  water  depth  before  proceeding  with  the  next 
time-step  calculation  of  bed  shear  stress. 

The  bed  source 


15.  The  form  of  the  bed  source  term,  S  =  +  °^~2  as 

given  in  Equation  G1  is  the  same  for  deposition  and  erosion  of 
both  sands  and  clays.  Methods  of  computing  the  alpha  coefficient 
depend  on  the  sediment  type  and  whether  erosion  or  deposition  is 
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occurring 


16.  Sand  transport.  The  supply  of  sediment  from  the  bed 
(i.e.,  the  sediment  reservoir)  is  controlled  by  the  transport 
potential  of  the  flow  and  availability  of  material  in  the  bed. 
The  bed  source  term  is 


(Gil) 


where 

S  *  source  term 

Cgq  =  equilibrium  concentration  (transport  potential) 
C  <*  sediment  concentration  in  the  water  column 

c  c  =■  characteristic  time  for  effecting  the 
transition 


17.  There  are  many  transport  relations  for  calculating 

ceq  for  sand  size  material.  The  Ackers-White  (1973)  formula  was 
adopted  for  this  model  because  it  performed  satisfactorily  in 
tests  by  WKS  and  others  (White,  Mill!,  and  Crabbe  1975;  Swart 
1976),  because  it  seems  to  be  complete,  and  because  it  is 
reasonably  simple.  The  transport  potential  is  related  to  sedi¬ 
ment  and  flow  parameters  by  the  expressions  in  the  following 
paragraphs  . 

18.  The  characteristic  time,  t  c  ,  is  somewhat  subjective. 
It  should  be  the  amount  of  time  required  for  the  concentration  in 
the  flow  field  to  change  from  C  to  Ceq  .  In  the  case  of 
deposition,  tc  is  related  to  fall  velocity.  The  following 
expression  was  adopted. 


t 

c 


larger  of 


Dr 


(GI2) 


whe  re 

Cc  *  characteristic  time 
Cj  *  coefficient  for  deposition 
D  =  flow  depth 
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fall  velocity  of  a  sediment  particle 


Vs 


DT  =  computation  time  interval 

In  the  case  of  scour,  there  are  no  simple  parameters  to  employ 
The  following  expression  is  used. 


t  =  larger  of 


(  G 1  3 


where 

=  coefficient  for  entrainment 
V  =  flow  speed 

19.  Clay  transport.  Deposition  rates  of  clay  beds  are 
calculated  with  the  equations  of  Krone  (1962). 


2V 


S  = 


2V.  5/3 

C 

D 


where 


H) 


for  C  <  C 


for  C  >  C 


=  bed  shear  stress 
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d  =  critical  shear  stress  for  deposition 
qc  =  critical  concentration  =  300  mg/1 


20.  Erosion  rates  are  computed  by  a  simplification  of 
Partheniades  (1962)  results  for  particle  by  particle  erosion. 
The  source  term  is  computed  by 


whe  re 

P  =  erosion  rate  constant 
Z  =  critical  shear  stress  for  particle  erosion 


(G1  6] 
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21.  When  bed  shear  stress  is  high  enough  to  cause  mass 
failure  of  a  bed  layer,  the  erosion  source  term  is 


where 


S 


TrpL 

DAt 


for 


T 


>  T 

s 


T 

L  =  thickness  of  the  failed  layer 
L  =  density  of  the  failed  layer 
At  =  time  interval  over  which  failure  occurs 
Z  s  -  bulk  shear  strength  of  the  layer 


The  bed  model 
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22.  The  sink-source  term  in  Equation  G1  becomes  a  source- 
sink  term  for  the  bed  model,  which  keeps  track  of  the  elevation, 
composition,  and  character  of  the  bed.  Bed  change  computations 
utilize  the  Or an k- N i cho 1  son  weighting  of  the  time-step  contribu¬ 
tions. 


23.  Sand  beds.  Sand  beds  are  considered  to  consist  of  a 
sediment  reservoir  of  finite  thickness,  below  which  is  a  nonerod 
ible  surface.  Sediment  is  added  to  or  removed  from  the  bed  at 
rate  determined  by  the  value  of  the  sink/source  term  at  the 
previous  and  present  time-steps.  The  mass  rate  of  exchange  with 
the  bed  is  converted  to  a  volumetric  rate  of  change  by  the  bed 
porosity  parameter. 

24.  Clay  beds.  Clay  or  mixed  sand  and  clay  beds  are 
treated  as  a  sequence  of  layers.  Each  layer  has  its  own 
characteristics  as  follows: 


a .  Thickness. 
J).  Density. 


£.  Age. 

<1.  Bulk  shear  strength. 


£.  Type. 

In  addition,  the  layer  type  specifies  a  second  list  of  charac¬ 
teristics. 


£.  Critical  shear  stress  for  erosion, 
b.  Erosion  rate  constant. 
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r.  i  n 


c_.  Initial  and  1-year  densities. 

d. -  Initial  and  1-year  bulk  shear  strengths. 

e.  Consolidation  coefficient. 
f_.  Clay  or  sand. 

New  clay  deposits  fora  layers  up  to  a  specified  initial  thick¬ 
ness  and  then  increase  in  density  and  strength  with  increasing 
overburden  pressure  and  age.  Variation  with  overburden  occurs  by 
increasing  the  layer  type  value  by  one  for  each  additional  layer 
deposited  above  it.  Change  with  time  is  governed  by  the  equa- 
t  ions 


f(t) 


f(t  )  +  [ f (t  )  -  f(t  )]  log  (9t  +  1)  0  <  t  <  1  year 
o  1  o  “ 


( G 1 8a  ) 


f(tj)  +  M  log  t 


1  year  <  t 


(  G  1  8  b  ) 


where 

f  =  time-varying  characteristic  of  density  or  bulk 
strength 

Lo  =  time  =  zero 
t|  =  time  =  1  year 
t  =  time 

M  =  consolidation  coefficient 


Mass  deposition  rates  are  converted  to  volumetric  deposits  by  the 
specified  density  for  the  type  1  layer,  and  erosion  rates  are 
converted  to  a  corresponding  volume  by  the  actual  density  of  the 
eroding  layer. 

25.  Use  of  the  layer  type  can  be  used  to  control  whether  or 
not  erosion  and  consolidation  are  allowed  to  occur,  and  to  keep 
track  of  sand  layers  in  a  mixed  bed  problem.  The  layer  structure 
and  time-varying  consolidation  can  be  used  to  specify  a 
subsidence  rate  for  the  modeled  area. 

26.  Bed  change  extrapolation.  The  model  is  run  in  a 
time-varying  mode.  The  time-varying  solution  of  the  bed  model 
may  be  advanced  in  time  by  direct  t i m e -s t e pp i ng ,  in  which  all  of 
the  equations  are  solved  at  each  time-step,  or  by  extrapolation, 
in  which  results  of  direct  time-stepping  are  projected  into  the 
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future.  The  extrapolation  capability  allows  simulation  for  an 
extended  period  of  time  at  a  fraction  of  what  t i m e -s t e p p i ng  would 
cost  for  the  same  duration. 

27.  The  computer  program  applies  four  constraints  to  limit 
or  control  the  duration  of  an  extrapolation  time  period  as 


follows: 

3  • 

The  water  depth  changes  by  no  more  than  PL 
percent, and/or 

b  . 

The  water  depth  average  change  is  no  more  than  D 
meters  at  nodes,  or 

c  . 

The  specified  maximum  time  limit,  T^  , 
is  reached 

d  . 

The  maximum  number  of  extrapolation  periods 
permitted  by  input  data  is  reached. 

28. 

specified 

For  each  node  at  which  the  depth  change  violates 
limits,  an  extrapolation  time  to  reach  the  limit 

t  he 

i  s 

computed.  If  N ^  nodes  reach  the  depth  change  limit,  the 
extrapolation  time  is  set  equal  to  the  average  of  the  individual 
node  time  limits. 

29.  When  an  extrapolation  time  has  been  determined  as 
described  above,  the  bed  change  rate  for  the  just-completed  time- 
stepped  simulation  is  averaged  with  that  since  the  end  of  the 
previous  time-stepped  simulation,  weighted  by  specified  factors 
zeta  and  1-zeta,  respectively.  The  resulting  average  rate  of  bed 
change  at  each  node  is  multiplied  by  the  extrapolation  time  to 
yield  a  maximum  extrapolated  change  (MEC)  in  bed  elevation  for 
the  extrapolation  interval.  From  this  point,  sand  and  clay  bed 
extrapolations  are  treated  differently. 

30.  If  the  specified  depth  constraint  limits  the  extrapola¬ 
tion  time  period  to  less  than  the  value  of  TL  ,  the  model 
returns  to  time-stepped  modeling  for  the  next  interval.  It  steps 
forward  in  time  for  the  same  number  of  time-steps  used  in  the 
initial  period,  then  extrapolates  again  as  described  above.  A 
specified  limit  on  number  of  extrapolation  periods  sets  the 
maximum  number  of  extrapolations  permitted,  which  is  simply  a 
cost-control  limit. 

31.  In  addition  to  the  overall  controls  described  above, 
extrapolated  bed  changes  at  every  node  are  always  limited  by 
these  three  constraints: 

Erosion  is  limited  to  that  which  exhausts 
the  bed  of  available  sediment. 

b^.  Deposition  is  limited  to  99  percent  of  the 
water  depth. 
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c.  In  mixed  bed  layering,  erosion  is  halted  when 
the  sediment  type  (sand  or  clay)  changes  from 
that  which  was  on  top  during  the  time-stepped 
period  . 

32.  The  thickness  of  the  sediment  reservoir  is  increased  or 
decreased  by  the  MEC  subject  to  the  restrictions  described  above. 
Two  options  are  available  for  clay  or  mixed  bed  extrapolation. 

In  the  preferred  method,  bed  layer  extrapolation,  variation  of 
bed  properties  is  considered  during  the  extrapolation  and  the  MEC 
is  used  only  as  an  upper  limit  on  depth  change.  The  alternate 
method  does  not  consider  nor  change  bed  structure  during  the 
extrapolation  period,  it  merely  raises  or  lowers  the  bed  eleva¬ 
tion  by  the  MEC. 

33.  Bed  layer  extrapolation  is  treated  as  follows: 

a.  At  nodes  with  a  sand  layer  on  top,  extrapola¬ 
tion  is  handled  in  the  same  manner  as  for  all¬ 
sand  beds,  except  that  the  sand  reservoir 
thicknessisequal  o  the  layer  thickness. 

b.  At  nodes  with  a  depositing  clay  layer 

on  top,  the  net  sediment  mass  deposited  is 
extrapolated.  This  extrapolated  mass  is 
then  deposited  on  the  bed  and  subjected  to 
the  same  overburden  and  time  rates  of 
consolidation  used  in  time -stepping. 

Either  the  net  increase  in  bed  elevation 
after  consolidation  or  the  MEC,  whichever 
is  smaller,  is  used  for  the  extrapolation 
change. 

£.  At  nodes  with  an  eroding  clay  layer, 

the  program  returns  to  a  t i me -s t e p p i ng 
mode  of  operation  to  calculate  bed 
shear  stresses  and  erosion  rates  at  each 
time -step  without  solving  the  convection- 
diffusion  equation  each  time.  Erosion 
continues  at  each  node  until  a  nonerodible 
layer  is  encountered  or  until  the  extrapo¬ 
lation  period  is  complete.  The  erosion 
depth  at  any  node  can  be  no  greater  than 
the  MEC. 

Program  Organization 

34.  STUDH  consists  of  two  piimary  modules.  An  input  module 
(PRKSKD)  reads  input  data  cards  and  organizes  the  data  into  the 
proper  sequence  required  by  the  computational  module.  Atter  all 
data  have  been  read  and  otganized,  PRESE  D  calls  the  computational 
module,  HORSED. 
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35.  Each  module  is  organized  with  a  main  routine  and  sup¬ 
porting  subroutines  as  shown  in  Figures  G 1  - G  3 .  Figure  Cl 
illustrates  the  organization  of  P  R  F,  S  E  D  and  HORSED  modules.  These 
figures  show  the  subroutine  listing  in  alphabetical  order,  not  in 
the  sequence  of  calls  from  the  code.  Occasionally,  a  subroutine 
name  will  appear  more  than  once.  Each  subroutine  is  assigned  a 
number  on  the  figure  when  that  subroutine  is  first  listed  and  the 
number  is  repeated  for  subsequent  listings.  This  is  intended  to 
show  each  external  reference  to  a  subroutine  not  only  by  the  main 
subprogram  of  the  module  but  also  by  each  subroutine  in  the 

mod  u 1 e  . 

36.  STUDH  uses  52  labeled  common  blocks  for  storage  of  data 
needed  by  more  than  one  subroutine.  The  library  source  version 
of  t tie  program  is  in  update  format  using  comdeck  labels  for  each 
of  the  common  blocks. 


Figure  G|.  STUDH  program  organization 
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PART  III:  PROGRAM  USE 


Introduction  to  Program  Use 


37.  STUDH  can  be  used  by  engineers  and  scientists  to  solve 
sediment  transport  problems  that  are  satisfactorily  described  as 
unsteady,  suspended  transport  in  two  horizontal  dimensions  with 
bed  interaction. 

38.  Users  are  cautioned  that  the  program  is  relatively  easy 
to  use  but  somewhat  more  difficult  to  use  properly.  Persons 
using  the  program  are  assumed  to  be  familiar  with  using  a  compu¬ 
ter  system.  Knowledge  of  numerical  methods  is  useful.  It  is 
essential  that  the  user  possess  considerable  knowledge  of  hydrau¬ 
lic  and  sedimentation  processes  and  that  he  or  she  understand  the 
computer  program  and  its  proper  use.  This  latter  requirement  can 
be  obtained  only  by  careful  training  in  practical  application  of 
STUDH. 


Use  of  the  Modeling  System 


39.  As  mentioned  previously,  STUDH  requires  that  hydro- 
dynamic  data  be  externally  supplied,  usually  by  a  numerical 
hydrodynamic  model.  A  modeling  sytem,  TABS-2,  has  been  designed 
to  satisfy  this  and  other  needs  for  a  comprehensive  modeling 
package.  TABS-2  consists  of  RMA-2V,  a  general  purpose  program 
for  hydrodynamic  modeling,  in  addition  to  STUDH  and  a  number  of 
utility  programs  that  develop  input,  translate  data,  analyze 
output,  and  provide  graphical  output  from  the  models. 


Access  to  the  Program 


40.  A  library  version  of  the  program  is  maintained.  To 
obtain  access  to  the  program  and/or  have  it  modified  to  run  on 
another  machine,  contact  WES.  Revisions  to  the  model  will  be 
made  occasionally,  but  all  input  decks  will  be  compatible  with 
the  new  version.  Users  with  access  to  the  program  receive  a 
documentation  page  describing  current  program  capabilities  and 
access  Instructions. 


Procedure  and  Input/Output  Files 
for  Executing  STUDH 


41.  STUDH  is  executed  via  PROCLV,  the  Job  Control  Language 
procedure  file  developed  for  TABS-2.  Current  instructions  for 
accessing  and  using  that  procedure  are  contained  in  Appendix  0: 
PROCLV  in  this  manual.  PROCLV  expects  the  default  logical  unit 
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assignments  as  shown  on  the  $L  card  instructions. 

42.  STUDH33  is  a  FORTRAN  program  in  PROCLV.  Tt  is  com¬ 
piled  at  execution  time  and  becomes  an  interactive  tutor  which 
guides  the  user,  step  by  step,  through  the  assignment  of  file 
names  for  all  input  and  output  files  at  execution  time.  If  any 
of  the  specified  input  files  do  not  exist  on  the  computer,  the 
program  will  abort. 

43.  A  sample  session  with  STUDH33  is  shown  opposite.  Out¬ 
put  from  STUDH33  is  the  job  control  language  which  submits  STUDH 
for  execution.  It  will  automatically  attach  the  input  files  and 
save  the  output  requested.  Printout  from  STUDH  automatically 
goes  to  the  line  printer. 

44.  Table  Gl  shows  the  required  and  optional  input  data 
files  for  STUDH.  The  generic  file  names  are  those  used  in  the 
procedure  file  documentation  (see  Appendices  N  and  0). 

Table  Gl 

Standard  Input  Files 


Generic 

File 

Name 

Standard 

Logical 

Unit 

Contents 

Status 

— 

05 

Run  control  data 

Required 

OMGED 

12 

Metric  geometry  file 

Required 

OMWSE 

9 

Metric  water  surface 
elevations 

Opt ional* 

OMVEL 

1  1 

Metric  velocity  input 

Optional* 

IWS  3 

3 

Wave  data  input 

Opt ional 

02S3 

70 

Prior  extrapolation  output 

Opt ional 

0 1  S  3 

87 

Concen t r a t i on/ bed  change 
ho  t  s  t  a  r  t 

Optional 

03S3 

88 

Cohesive  bed  structure 

Opt iona  l 
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OBEGIN  ,  STUDH33  ,  PROCLV  , 

*  STUDH  3.3  JOB  SETUP* 

ENTER  JOB  TIME  LIMIT  (<CR>  FOR  120110): 

I> 

ENTER  1  OR  2  DIGIT  JOB  PRIORITY  (<CR>  FOR  2): 

I> 

ENTER  YOUR  LAST  NAME: 

I5THOMAS 

ENTER  FILENAME  FOR  STUDH  CONTROL  INPUT: 

I5GRINST 1 

ENTER  FILENAME  FOR  METRIC  GEOMETRY  (<CR>  IF  NONE): 

I > GROW  R 1  1 

ENTER  FILENAME  FOR  METRIC  VELOCITIES  (<CR>  IF  NONE): 
I>GRR20U 1 

ENTER  FILENAME  FOR  WATER  SURFACE  (<CR>  IF  NONE): 

OGRR2WSL 

ENTER  FILENAME  FOR  WAVE  INPUT  (<CR>  IF  NONE): 

I> 

ENTER  FILENAME  FOR  HOTSTART  (<CR>  IF  NONE): 

I> 

ENTER  FILENAME  FOR  EXTRAP.  INPUT  (<CR>  IF  NONE): 

I> 

ENTER  FILENAME  FOR  CONC/DELBED  OUTPUT  (<CR>  IF  NONE): 
I>GRSTOU 1 

ENTER  FILENAME  FOR  EXT  RAP . OUTP UT  (<CR>  IF  NONE): 

I> 

ENTER  DM  S  20  CHARACTER  CATALOG  NAME  FOR  FILE  (CR) 
SITE-SOURCE-PLAN-CFS-COND-STORE-FORM-CAT-SUBCAT-MISC 

(1)  (1)  (2)  (2)  (6)  (I)  (1)  (1)  (1)  (3) 

LAST  COLUMN  IS  HERE! 

I>  1  10  1  6  7  09MR8  1  1 1S1000 

ENTER  THE  GRADE  FOR  THIS  FILE  <CR> 


ENTER  YOUR  LAST  NAME  <CR> 

OTHOMAS 

ENTER  80  CHAR  OR  DESCRIPTIONS  <CR>  THEN  80  MORE  <CR> 

I >T H I S  DEMONSTRATES  THE  INTERACTIVE  SESSION  TO  RUN  STUDH 
I  > 1 5NOV 1  98  3  W.  A.  THOMAS 

DOES  EVERYTHING  LOOK  OK?  ENTER  (YES  OR  NO)  <CR> 


S  T  U  D  H 


G  2  0 
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45.  Jobs  executed  on  a  vector  processing  computer  produce 
binary  files  that  can  be  read  only  on  those  respective  machines. 
PROCLV  automatically  directs  utilities  and  the  main  codes  to  the 
proper  machine  for  saving  and  accessing  files. 

46.  The  file  referred  to  as  STUDH  CONTROL  INPUT  in  the 
STUDH33  session  is  the  card  image  input  for  STUDH  described  in 
this  document.  It  is  usually  entered  into  a  file  with  the  editor 
and  consequently  is  an  ASCII  character  set  that  can  be  transfer¬ 
red  back  and  forth  from  the  front  end  computer  to  the  vector 
processing  computer. 


Description  of  Card  Image  Input  Data 


47.  Input  to  the  program  consists  of  card  image  data  in  the 
format  used  by  HEC-6  (Thomas  1976)  and,  optionally,  data  files  on 
disk  or  tape.  The  card  images  may  be  actual  cards  or  lines  in  a 
data  file.  Card  images  consist  of  10  fields  of  8  columns  each. 
The  first  two  columns  are  used  to  identify  the  type  of  data  on 
the  card.  Coding  instructions  for  input  data  are  given  in 
Addendum  G-l. 

48.  Eleven  classes  of  input  data  describe  the  computational 
mesh,  physical  constants,  properties  of  the  flow,  and  properties 
of  the  sediment.  The  following  paragraphs  describe  the  input 
data  in  detail.  A  summary  of  input  data  is  given  in  Addendum 

G-l  . 

Title  cards  ( T 1  ,  T3) 

49.  These  cards  contain  descriptive  information  used  to 
identify  a  model  run.  As  many  T1  cards  can  be  used  as  are 
needed.  The  final  title  card  must  be  a  T3  card.  Information  on 
the  T3  card  is  saved  with  the  program  output  files  (along  with 
data  management  banners,  if  used),  so  it  can  be  used  to 
identify  the  data  file. 

Run  control  cards  ($T,  $L,  $H,  $$END) 


50.  These  cards  are  used  to  control  various  aspects  of 
program  control.  The  $T  cards  dictate  at  what  time-steps  output 
is  to  be  printed  and  input  files  are  to  be  read.  Information 
requested  by  the  $T  cards  may  be  given  there  or  in  an  alternate 
format  following  the  $  $END  card,  but  the  requested  information 
must  be  furnished.  The  PS  cards  specify  the  mesh  locations  at 
which  output  is  printed.  THE  $L  card  is  not  usually  needed  but 
is  available  in  case  the  user  wishes  to  change  some  of  the  input 
or  output  logical  unit  designations.  If  the  card  is  omitted,  all 
logical  units  assume  the  default  values  shown. 

51.  The  $H  card  is  used  to  control  HOTSTART  runs  of  the 
program.  In  a  coldstart,  a  model  run  begins  fresh,  not  using  the 
results  of  any  previous  run  as  a  starting  point.  In  a  hotstart. 


G  2  1 
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some  of  the  variables,  such  as  concentration  or  bed  thickness, 
begin  with  values  that  were  computed  in  a  previous  run. 


52.  The  files  needed  for  hotstarting  a  model  run  are  writ¬ 
ten  every  time  the  program  is  run;  however,  unless  they  are  saved 
by  job  control,  the  files  are  not  retained.  In  order  to  make  a 
hotstart  run,  first  submit  a  model  run  in  which  logical  output 
units  18  (bed  structure)  and/or  7  (concentrations  and  bed  eleva¬ 
tion  changes)  are  saved.  Then  submit  a  run  with  the  appropriate 
hotstart  switches  on  the  $H  card  and  access  logical  input  units 
88  (bed  structure)  and/or  87  (concentrations  and  bed  elevation 
changes). 

53.  In  a  coldstart  run,  all  of  the  important  processes  must 
spin-up  from  an  artificial  condition  such  as  a  uniform  sediment 
concentration  field.  The  spin-up  time  is  the  length  of  time  a 
simulation  must  run  before  the  solution  has  recovered  from  the 
artificial  initial  condition.  For  example,  in  a  sand  bed 
problem,  if  the  initial  sediment  concentrations  are  too  low  in 
one  area,  erosion  of  the  bed  may  occur  there  during  spin-up,  even 
if  the  prototype  bed  is  stable  in  that  area.  To  overcome  this 
problem,  a  second  hotstart  model  run  would  be  made  in  which 
concentrations  are  hotstarted  from  the  previous  run,  but  bed 
structure  and  bed  elevation  changes  are  coldstarted. 

54.  Use  of  the  $  H  card  permits  any  one  or  a  combination  of 
the  three  variables  (concentration,  bed  elevation,  and  bed  struc¬ 
ture)  to  be  used  in  a  hotstart. 

Trace  Printout  (TR  cards) 


55.  Use  of  the  $TP  card  or  the  first  card  following  $  $  E  N  D 
controls  the  output  of  the  important  model  results  of  concentra¬ 
tion  and  bed  change.  The  primniv  purpose  of  the  trace  printout 
controls  is  to  assist  in  diagnosing  problems  with  a  run,  but  they 
also  provide  for  printing  of  some  parameters  that  may  be  useful 
in  interpreting  model  results.  If  a  trace  printout  is  selected, 
it  will  print  only  at  the  times  dictated  by  the  STPor  $  $  E  N  D 
cards,  and  only  at  the  locations  specified  on  the  PS  cards  if 
they  are  present. 

Geometry  cards  ( C 1  , G 3 , G B , G S , GE , G4  ,  GN , C 7  ,  and  CD) 


5 h .  The  program  contains  an  internal  mesh  generator  for 
those  problems  that  do  not  require  separate  modeling  of  flows. 

In  those  cases,  it  may  be  convenient  to  use  the  internal  mesh 
generator,  but  in  general,  it  is  more  efficient  to  use  the  sepa¬ 
rate  TA8S-2  mesh  generation  programs. 


37.  When  a 
cations  of  model 
by  use  of  the  G  V 


mesh  has  been 
locations  and 
and  G  N  cards. 


separately  generated,  its  specif  i- 
bed  elevation  cannot  be  overridden 
Hotstarting  bed  elevation 
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change  with  a  $H  card  does  not  change  the  original  bed  elevation; 
but  by  giving  a  nonzero  bed  elevation  change,  it  alters  the 
effective  elevation  of  the  bed  for  that  run. 

58.  For  model  runs  in  which  a  portion  of  the  mesh  may  be 
out  of  the  water  at  some  time,  a  GD  card  is  required.  Otherwise, 
an  error  is  diagnosed.  The  CD  card  permits  specification  of  a 
water  depth  (DSET)  at  which  drying  is  assumed  to  occur  and  the 
node  is  removed  from  calculations.  The  value  of  DSET  should 
correspond  (in  metric  units)  to  the  value  of  the  rewetting  depth 
(DSETD)  used  in  the  RMA-2V  run  that  supplied  the  hydrodynamics. 

Timing  and  run  length  control  (TZ  and  TE  cards) 


59.  The  T Z  card  specifies  the  starting  date  and  time  of  the 
run.  If  time-varying  boundary  conditions  are  used,  all  of  these 
variables  must  be  specified.  The  card  also  specifies  the  computa¬ 
tional  interval  and  number  of  time-steps  to  be  run. 

60.  Choice  of  a  computational  interval  is  dependent  on  the 
size  of  mesh  cells  used,  speed  of  the  flow,  effective  settling 
velocity  of  the  sediment,  and  how  well  the  modeler  wishes  to 
resolve  small-scale  bed  features.  For  most  production  work.,  an 
interval  of  15  min  (900  sec)  has  been  found  satisfactory,  but 
some  experimentation  may  be  required  to  find  the  best  value. 

61.  To  obtain  the  number  of  time-steps  needed  to  reach  a 
given  length  of  run,  use  the  equation 

No.  of  time-steps  =  _ Run  Length  +  1 

Computational  Interval 

62.  Use  of  the  TE  card  permits  longer  run  times  to  be  used 
at  a  cost  (computer  cpu  time)  lower  than  possible  with  direct 
time-stepping.  This  is  accomplished  by  an  Interval  extrapolation 
procedure. 

63.  Figure  G4  Illustrates  the  extrapolation  process  for 

results  of  the  bed  elevation  change  (DELBED)  at  one  node  in  a 
hypothetical  model  run.  During  the  first  t imp-stepping  cycle 
(A),  the  bed  elevation  changes  at  each  computational  interval 
(  t),  with  deposition  during  some  intervals  and  erosion  during 

others.  Over  the  time-stepping  period,  more  deposition  occurs, 
soDELBED  at  the  end  ot  the  run  is  positive.  The  length  of  the 
time  —  stepping  cycle,  T  j  S  *  is  as  specitied  on  the  TZ  card. 

64.  At  the  end  o  I  the  first  time -stepping  cycle,  extrapola¬ 
tion  No.  1  begins.  The  net  bed  elevation  change  iron)  time  zero 

to  ^TS  used  to  calculate  an  average  rate  of  bed  change  at  each 

node.  This  average  rate  of  change  is  assumed  to  remain  constant 
during  the  first  extrapolation  (B).  The  extrapolation  period 
length,  Tp-j  .  is  determined  hy  how  long  it  takes  to  reach  one  of 
several  limits  on  bed  change  or  run  length. 
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STUDH  EXTRAPOLATION 


These  liaits  are  discussed  later.  During  the  extrapolation, 
concentration  and  flow  velocities  do  not  change. 


65.  At  the  end  of  extrapolation  No.  1,  t i me - s t e p p i ng  is 
repeated  (C).  The  unit  flows  and  boundary  conditions  are  exactly 
repeated  from  t i me -s t e pp i ng  No.  1,  but  velocities,  concentra¬ 
tions,  and  erosion/deposition  rates  are  recomputed  using  the  new 
bed  elevations.  Note  that  since  the  water  is  now  shallower  at 
the  example  node,  deposition  rates  are  lower  and  erosion  rates 
are  higher  than  before.  The  length  of  t i me -s t e pp i ng  No.  2  is 
exactly  the  same  as  No.  1,  Tys  . 

66.  At  the  end  of  time-stepping  No.  2,  the  average  rate  of 
bed  change  over  that  interval  is  calculated  and  used  for  extrapo¬ 
lation  No.  2  (D).  Extrapolation  No.  2  is  shorter  than  extrapola¬ 
tion  No.  1,  either  because  the  elevation  change  at  some  nodes  is 
greater  than  before  or  because  the  time  limit  (Tmax)  is 
approaching.  Each  run  must  end  with  a  complete  time-stepping 
cycle  of  duration  TfS  • 

67.  At  the  end  of  t  i  m  e  -  s  t  e  p  p  i  n  g  No.  3  (E),  the  run  is 
completed . 

68.  Three  limits  are  used  to  determine  how  long  an  extrapo¬ 
lation  period  lasts.  EXDYMX  is  the  maximum  absolute  bed  change 
in  metres  that  will  be  permitted  at  one  or  more  nodes  (when  more 
than  one  node  is  used  EXDYMX  is  the  maximum  average  change  per¬ 
mitted  at  the  number  of  specified  nodes).  EXPDMX  is  the  maximum 
bed  elevation  change  in  terms  of  percent  of  water  depth.  Thus  a 
1-m  bed  elevation  change  in  10-m  deep  water  is  equivalent  to  2  m 
in  water  20  m  deep.  For  multiple  nodes,  the  average  is  used. 

The  third  limit  on  extrapolation  time  is  the  maximum  time  (EXDT) 
that  the  model  run  is  to  reach.  Since  each  model  run  must  end 
with  a  complete  cycle  of  time-stepping,  extrapolation  will  end  at 
a  time  that  permits  the  final  time-stepping  to  occur,  even  if  the 
depth  limits  are  not  exceeded. 

69.  If  the  depth  limits  are  imposed  on  a  single  node, 
extrapolation  times  may  be  very  short.  To  avoid  having  one  badly 
behaving  node  abort  an  extrapolation,  the  variable  N0N0D  may  be 
used.  IK  N0N0D  is  greater  than  one,  the  average  depth  change  at 
N0N0D  number  of  nodes  and  EXPDMX  are  used  for  calculating  permit¬ 
ted  extrapolation  time. 

70.  Values  of  EXDYMX,  EXPDMX,  and  N0N0D  must  be  developed 
by  experimentation,  but  typical  choices  are  0.5  m,  10  percent, 
and  20,  respectively. 

71.  In  the  hypothetical  example  shown  in  Figure  C4,  only  the 
most  recent  time-stepping  period  results  are  used  to  determine 
the  average  rate  of  bed  elevation  change  at  each  node.  This 
corresponds  to  an  implicitness  factor  (  Z  F.  T  A )  of  1.0.  For  smaller 
values  of  ZETA,  the  last  two  time -stepping  periods  are  used  to 
compute  a  weighted  average  rate  of  bed  change,  with  small  values 


d?5 
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of  ZETA  emphasizing  the  prior  t i m e - s t e p p i ng  period  over  the  most 
recent  one. 

72.  The  program  gives  the  option  of  leaving  bed  structure 
constant  during  the  extrapolation  period  or  attempting  to  compute 
the  effect  of  continued  ned  change  during  extrapolation.  The 
value  of  MTEX  controls  this  option.  A  value  of  zero  is  less 
expensive  and  should  be  used  unless  a  good  reason  exists  for 
evaluating  bed  structure.  The  computation  procedure  is  an  at¬ 
tempt  to  reproduce  changes  that  would  occur  if  genuine  time¬ 
stepping  were  occurring,  but  the  calculations  can  only  offer  a 
rough  approximation  to  the  actual  processes. 

73.  The  variable  M E X  on  the  TE  card  is  used  to  prevent 
runaway  costs  in  extrapolation  runs.  It  limits  the  number  of 

t  i  m e - s t e p p i ng  sequences  that  are  performed  and  can  cause  a  run  to 
fall  short  of  the  desired  time.  If  it  is  too  small,  the  desired 
time  will  not  be  reached  and  a  warning  will  be  printed.  If  it  is 
too  large,  computer  costs  may  be  excessive. 

Implicitness  factor  ( TT  card) 

74.  The  program  uses  the  Crank-Nicholson  time-stepping 
scheme  that  employs  an  implicitness  factor,  Theta  .  A  value  of 
0.66  is  recommended,  but  variations  from  0.5  (equal  weighting 
of  this  time-step  and  Che  previous  time-step)  to  1.0  (no  in¬ 
fluence  from  the  previous  time-step)  are  permitted.  A  higher 
value  of  Theta  produces  results  that  are  more  stable  but  in¬ 
creases  numerical  (artificial)  dispersion  of  sedimen  . 

Selective  print  (PS  card) 

73.  The  PS  card  specifies  the  mesh  locations  at  which  model 
results  are  printed.  Times  of  printed  output  are  select  d  by  the 
STP  or  IFF  card  sets.  If  the  PS  card  is  omitted,  all  nodes  and 
elements  are  Included  in  the  printed  output.  If  elements  are 
specified  on  the  PS  card,  only  those  elements  and  nodes  sur¬ 
rounding  them  are  included  in  the  printout. 

Sediment  size  classes  (SA,SR,ST,  and  WC  cards) 

76.  The  program  requires  that  sediment  sizes  and/or  their 
characteristics  be  specified.  For  noncohesive  sediment  bed  prob¬ 
lems,  input  allows  for  multiple  grain  sizes  on  the  SA  card,  BUT 
AT  PRESENT  THE  PROGRAM  CONSIDERS  ONLY  ONE  SIZE  AT  EACH  NODE.  The 
grain  size  specified  on  the  SA  card  is  applied  to  every  node  in 
the  mesh.  Values  at  specific  nodes  may  be  changed  by  use  of  the 
SR  and  ST  cards.  The  ST  card  specifies  grain  sizes  to  be  used  in 
noncohesive  sediment  transport  equations  and  the  SR  card  speci¬ 
fies  the  effective  grain  size  to  be  used  in  bed  roughness  calcu¬ 
lations  (Ack?rs-White  transport  equations  only).  These  two  sizes 
will  b'  the  same  only  for  plane  beds  in  straight  channels.  Bed 
forms  and  channel  curvature  introduce  form  roughness  that  causes 
the  SR  sizes  to  be  larger  tian  sizes  used  for  transport 
com  put  at  ions . 
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77.  Note  that  the  SA,  SR,  and  ST  cards  constitute  a 
cascading  set  of  defaults.  If  neither  an  SR  nor  ST  card  is 
present,  the  grain  size  on  the  SA  card  will  be  used  at  all  nodes 
for  both  transport  and  effective  roughness.  If  SR  cards  are 
present,  they  override  the  SA  card  at  those  nodes  specified  and 
become  the  default  values  for  the  ST  card  values.  Finally,  use 
of  ST  cards  overrides  the  SR  and  SA  card  input  at  every  node 
specified  on  the  ST  card. 

78.  Two  characteristic  length  parameters  are  requested  on 
the  SA  card.  Cl.UK  is  the  length  factor  for  deposition.  The 
default  is  a  value  oi  I,  corresponding  to  an  average  settling 
depth  equal  to  the  water  depth.  For  fine  sediments  that  are 
distributed  throughout  the  water  column,  a  value  of  0.5  is  recom¬ 
mended.  For  coarser  sediments  in  less  turbulent  flows,  a  smaller 
value  is  suggested.  Cl.KR  is  the  length  factor  for  erosion.  The 
default  value  of  111  is  suggested,  but  more  investigation  is 
needed  to  find  the  hest  value. 

79.  Settling  velocities  are  specified  on  the  WC  cards. 

This  settling  velocity  is  an  effective  fall  velocity  which  goes 
up  with  grain  size,  goes  down  with  increasing  turbulence,  goes  up 
with  increasing  aggregation  (cohesive  sediments),  and  goes  up  if  a 
too  large  value  of  CLdK  is  used.  The  best  starting  point  for 
noncobesive  sediments  are  fall  velocities  for  spherical  particles 
of  equal  diameters.  Figure  C,5  shows  a  typical  graph  for  settling 
velocities. 

80.  For  colesive  sediments,  the  settling  velocity  of  parti¬ 
cles  can  vary  enormously  with  sediment  type,  salinity,  turbu¬ 
lence,  and  other  chemical  and  physical  conditiions.  Laboratory 
or  field  tests  are  needed  to  define  effective  settling  veloci¬ 
ties  (see  Appendix  K). 

Cohesive  sediment  characteristics  (SC 
and  DT  cards) 

81.  Figure  (,  f>  illustrates  the  relation  between  the  various 
critical  ;hear  stresses  tor  cohesive  sediments.  These  values 
must  generally  he  determined  by  laboratory  or  field  experimenta¬ 
tion,  but  published  results  for  similar  sediments  can  be  used  if 
caution  is  exercised. 

82.  Values  specified  on  the  SC  card  for  critical  shear 
stresses  for  erosion  an  d  the  erosion  rate  constant  are  overridden 
by  those  contained  on  the  l)T  cards.  The  DT  cards  are  used  to 
assign  characteristics  to  various  types  of  cohesive  sediment  bed 
layers.  These  characteristics  are  assigned  to  existing  bed 
layers  as  specified  on  the  DC  cards  and  to  new  layers  as  they  arc- 
deposited.  Freshly  deposited  sediments  are  assigned  a  type  1 
designation  and  increase  to  higher  numbered  types  as  the  thick¬ 
ness  ot  sediment  above  them  Increases.  Data  for  the  DT  cards 
should  come  f  r  o  .,i  laboratory  tests  on  the  sediments  t(  b-’  modeled. 
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Figure  C6.  Cohesive  bed  behavior  as  a  function  of  shear 
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8  3. 

calculated 


Dry  density  as 
by  the  following 


specified 
formula  : 


o  n 


the 


DT  cards  can  be 


w  h  e  r  e 


Pd.ft)  ~  P'3  ( P»  ~  P^>  ) 

fa  -  P«) 


s 

B 

w 


density  of 
hulk  (wet) 


individual  sediment  particles 
density  of  sediment 


density  of 


water  entrained  in  the  sediment 


(C19) 


Note  that  a  lower  density  for  layer  types  1  -  k  will  result  in 
fluffier  deposits.  Increased  thickness  of  deposited  layers,  and 
greater  bed  change. 

8-'t.  Density  and  shear  strength  of  cohesive  layers  generally 
increase  as  they  consolidate.  The  shifting  to  higher  layer  types 
in  the  program  accounts  for  this,  but  the  computations  associated 
with  layer  consolidation  are  fairly  involved.  If  these  computa¬ 
tions  are  not  nee  d  e  d  for  accuracy,  it  is  more  economical  to 
decrease  the  number  of  layers  that  are  subject  to  consolidation 
(  M  N  C  L  oti  the  SC  card)  and  Increase  the  typical  thickness  of  the 
consolidating  layers  (THKTYP  on  the  DT  cards). 

Bed  structure  (DV  and  DC  cards) 

^  •  fhe  thickness  of  the  sediment  bed  at  the  beginning  of  a 
run  is  specified  on  the  DV  (noncohesive)  and  DC  (cohesive)  cards. 
If  that  thickness  is  eroded,  it  is  assumed  that  none  rod i ble  rock 
has  been  reached.  The  DC  cards  specify  which  layer  types  (DT 
cards)  are  present  ,  how  thick  each  is,  and  how  old  each  is. 

During  extrapolation  runs  (TK  card),  the  age  of  a  layer  is  used 
to  perform  calculations  for  consolidation  with  time. 

Mb.  In  hotstart  runs  ($H  card),  the  bed  structure  from  a 
previous  run  is  used  and  information  on  the  DC  and  DV  cards  is 
disregard e d  . 

_ !_*  i  I  fiision  (EX  and  F.  Y  cards) 

'  ,  .  I'i  t  i  us  i  on  of  suspended  sediment  occurs  because  of  tur- 
'  •’  1  ''  '  n  '  ’’  •’  flow  field.  W  tie  n  the  transport  equation  is  sim- 
'tied  h  v  averaging  over  depth,  as  in  S  T  U  D  H ,  dispersion  is 
'  r  od  m  i  "  d  because  of  vcrtic.il  variations  in  the  flow  field  and 
t  t  1  i  u  g  hi  t  ‘i  e  sediment  through  the  water  column.  In  practice, 

’  s  i' t  i  s  lumped  together  with  turbulent  diffusion  and  the 

!  i  c  t  ri|  averaging,  in  time  and  the  combined  effect  is  called 
>.  oe  r  •:  i  on  or  effective  diffusion.  In  numerical  modeling  of  the 
a  n  s  p  d  r  t  e q  ■  i  a  t  i o  n s ,  an  additional  dispersive  effect  is  intro- 
1  11  !  when  continuous  horizontal  concentration  profile  is 

i.  in 


t  h 

P  f 

n  i 
t  r 

ill 
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represented  in  a  discretized  fashion  by  the  nunerical  mesh.  In 
this  program,  these  various  effects  are  combined  in  a  pair  of 
effective  diffusion  coefficients  given  on  the  EX  and  EY  cards. 

88.  Selection  of  appropriate  values  for  the  dispersive 
coefficients  is  not  a  straightforward  task.  Elder  (1959)  gave 
approximate  expressions  for  longitudinal  (direction  of  flow) 
turbulent  diffusion  coefficients  as 

De  =  5.93  Du*  ( G20 ) 

and  for  the  transverse  (perpendicular  to  the  flow  direction) 
diffusion  coefficient  as 


Dt  =  0.23  Du* 


where 


(  G  2  1  ) 


D  =  water  depth,  and 

u*  =  shear  velocity  as  given  by  equation  8. 

Experimentally  derived  values  of  the  constants  in  Equations  G20 
and  G21  are  often  orders  of  magnitude  greater  than  those  given. 
This  is  attributed  to  nonuniformity  of  the  flow,  wind  effects, 
wave  effects,  and  so  on. 

89.  In  choosing  an  effective  diffusion  coefficient  to  use 
in  numerical  modeling,  consideration  must  also  be  given  to  the 
mesh  cell  size.  Exact  relations  are  not  available,  but  general¬ 
ly,  larger  element  sizes  require  larger  diffusion  coefficients. 

90.  Allen  Teeter  of  the  WES  Hydraulics  Laboratory  has 
suggested  that  an  equation  of  the  form 

E  =  K1  (K2Du*  +  1  0  ~ 3 Jt. 2  >  (  G  2  2  ) 


where 


=  the  element  size 
Kj  and  K2  =  cor,stants 


91.  Equations  G20-G22  differentiate  between  dispersion 
coefficients  parallel  and  transverse  to  the  direction  of  flow. 
Since  the  coefficients  in  the  present  version  of  STUDH  apply  in 
the  x-  and  y-dlrections,  not  necessarily  in  the  flow  directions, 
these  equations  can  be  used  only  as  a  guide. 


92.  fortunately,  in  most  applications,  effective  diffusion 
is  smaller  than  convection  by  the  calculated  flow  velocities,  so 
a  wrong  choice  does  not  affect  the  results  very  much  unless  the 
chosen  coefficient  is  far  too  large.  The  best  approach  then  is 
to  use  a  moderately  high  value  (say  50  m^/sec)  during  the  first 
few  runs,  then  reducing  the  coefficients  to  the  least  values  that 
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will  run  without  introducing  excessive  numerical  instability  (as 
revealed  by  negative  concentration). 

93.  Table  G2  lists  some  previous  applications  and  the 
effective  diffusion  coefficients  that  were  used. 


Table  G2 

Example  Dispersion  Coefficients 


Location 

Typical  Current 
Speed,  mps 

Typical  Element 
Size,  km 

Dispersion 

Coefficient 

mjLsec 

Medium-size  river 

1-1.5 

0.1  -  0.5 

100 

Open  bay 

0.5  -  1.0 

0.75 

100 

Tidal  river 

0.2  -  1.0 

0.1  -  0.3 

5-10 

Initial  concentration  (1C  cards ) 


94.  The  nodal  concentrations  at  the  first  time-step  are 
specified  on  the  IC  cards,  or  in  a  file  if  a  hotstart  is  used 
(paragraph  5  1,  $  H ) . 

95.  Depending  on  the  length  of  a  run,  the  initial  concen¬ 
trations  can  have  a  significant  effect  on  the  results.  If  they 
are  too  high,  deposition  will  be  high  for  the  first  few  time- 
steps;  and  unless  the  run  is  long  enough  to  overcome  this  start¬ 
up  anomaly,  the  end  result  will  be  biased.  For  noncohesive  sedi¬ 
ments,  the  same  will  be  true  if  the  initial  concentrations  are 
too  low. 

96.  To  overcome  these  problems,  it  is  best  to  use  field 
data  to  obtain  an  approximation  to  actual  concentrations;  to  make 
an  initial  spin-up  run  to  stabilize  concentrations,  then  hot¬ 
start;  or  to  run  for  a  period  long  enough  to  make  start-up 
perturbations  small  with  respect  to  the  results  produced. 

Boundary  conditions  (BC  cards) 


97.  BC  cards  are  used  to  prescribe  concentrations  at  the 
water  boundaries  of  the  models.  Concentrations  need  not  be 
specified  at  land  boundaries.  Boundary  concentrations  are  best 
when  based  on  field  measurements;  but  for  noncohesive  sediments, 
the  model  is  somewhat  more  flexible. 

'IK-  If  the  model  boundaries  are  sufficiently  tar  from  the 
area  of  interest  in  noncohesive  sediment  bed  studies,  the  model 
will  rend  to  compensate  for  imprecise  boundary  concentrations. 

It  concentrations  are  too  low  on  an  incoming  flow  boundary,  the 
model  will  erode  material  from  the  bed  (if  the  specified  reser¬ 
voir  thickness  is  adequate)  to  put  enough  sediment  in  transport 
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to  equal  the  bed  material  transport  capacity.  If  con cen t r a t i ons 
are  too  high,  the  excess  material  will  deposit,  again  bringing 
the  concentration  to  that  needed  to  satisfy  transport  capacity. 
The  rows  of  computational  elements  near  the  boundaries  will  have 
erroneous  deposition/erosion  effects  under  these  conditions  and 
results  therefore  should  not  be  used. 

99.  This  tendency  for  noncohesive  bed  models  to  heal  the 
boundary  conditions  is  a  fortunate  one,  but  it  should  not  be 
strained.  For  example,  a  too-high  boundary  concentration  will 
form  a  delta  at  the  inflow  point.  If  the  model  run  is  long 
enough,  the  delta  will  propagate  throughout  the  area  of  interest, 
producing  erroneous  results.  The  boundaries  should  be  suffi¬ 
ciently  removed  from  the  problem  area  and  an  attempt  should  be 
made  to  adjust  boundary  concentrations  that  are  seriously 
different  from  nea r -e q u i 1 i b r i u ra  conditions.  Note  that  this 
healing  process  does  not  apply  to  cohesive  sediments. 

100.  For  boundaries  at  which  there  is  always  flow  out  of 
the  model,  for  example,  a  downstream  section  in  a  nontidal  river, 
boundary  concentrations  can  be  left  unspecified,  and  the  program 
will  calculate  the  outflowing  concentrations. 

Description  of  Output 

101.  Output  from  a  model  run  consists  of  summaries  of  input 
data,  computed  parameters,  and  computed  results.  Input  data 
summaries  include  an  echo  of  all  card  image  input  data  and  a 
tabulation  of  options  and  sediment  characteristics  that  have  been 
chosen.  A  number  of  data  set  codes  are  output  that  are  of  use 
primarily  in  debugging.  A  listing  ol  program  dimensions  is 
provided  and  data  management  system  banners  from  input  files 
(geometry,  hydrodynamics,  and  hot  start  data)  are  printed.  These 
summaries  should  he  carefully  reviewed  to  ensure  that  input  data 
were  correctly  specified  and  interpreted  by  the  program.  Exam¬ 
ples  are  shown  in  Figures  G7-G9. 

102.  At  selected  time -steps,  some  results  and  some  asso¬ 
ciated  parameters  are  printed  for  selected  nodes  and  elements 
(see  paragraph  75).  Standard  results  output  includes  suspended 
sediment  concentration  in  kilograms  per  cubic  metre  at  the  nodes 
(Figure  G10);  flow  speed  in  metres  per  second;  water  depth  in 
metres;  total  hod  change  in  metres  from  the  start  of  the  run; 
volume  of  bed  change  in  cubic  metres  for  the  elements;  and  net 
bed  change  (algebraic  sum)  and  gross  bed  change  (sum  of  absolute 
value  )  in  c  u  r>  i  r  met  re:;  over  the  entire  mesh  to  that  point  in  the 
run  (  i  g  .ire  (.11). 

10).  (Extrapolation  runs  produce  printed  output  during  ex¬ 
trapolation  periods  showing  which  nodes  control  the  extrapolation 
and  the  amount  of  extrapolated  depth  change  at  the  nodes.  An 
example  is  shown  in  Figure  GI2. 
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Figure  GS.  Sample  STUDH  printout  showing  input  codes  and 
hydrodynamic  input  files  banners 
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Figure  Gil 


Sample  STUDH  printout  showing  trace  print 
information  from  subroutine  BEDSUR 


S  I  [1 !)  H 


GIB 


04/85 


*****SUBR0UTINE  E  X TRAP01 ATE$*$t* 


EXTRAPOLATION  NO.  1 

CONSTRAINTS  ON  MAX •  PERMISSIBLE  EXTRAPOLATION  ARE 


2.000  METERS,  ANO/OR 
20.000  PERCENT  OF  OEPTM  AT  I 
432000.00  SECONDS. 


RRAT  ERAT 


OT  RTIP  NTTS, 


.555S56E04  .0 


3600.00  18000.00  6 


CALCULATED  EXTRAPOLATION  TIME  PERIOD  <SEC)=  396000.00 
IETA  x  .500 

IS  CONTROLLEO  BY  TIME  LIMIT 


TIME  TO  =  STARTING  TIME 

TIME  T 1  =  START  OF  PREVIOUS  STUOH  SIMULATION  PERIOD* 
TIME  T 2  =  ENO  OF  PREVIOUS  STUOH  SIMULATION  PERIOD  = 
TIME  T  3  =  ENO  OF  THIS  ST  UDH  EXTRAPOLATION  PERIJO  = 
PERCENT  OF  TOTAL  TIME  PERIOD  OF  STUOY  (TIMEX/EXOT)  = 


.0 

18000.000 

414000.00 

93.833333 


Figuro  G  1  2  . 


Sample  STUD  11  printout  showing  intei.ial 
extrapolation  resul  t  s 


00  NOOES, 


(.3  9 


ST  UDH 
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104.  A  number  of  specialized  output  results  are  available 
through  the  trace  printout  (TR)  cards.  Most  are  detailed 
listings  of  the  input  data  or  parameters  calculated  from  input 
data.  K  S  W  (  3 )  controls  output  in  the  bed  computation  module  and 
can  provide  for  detailed  results  of  bed  structure  and  rates  of 
erosion /deposit  ion.  Table  G  1  lists  the  column  headings  in  this 
output  and  explains  what  each  means. 

TAB1.K  G3.  HEDSUR  A N 11  BEDXCG  OUTPUT  HEADINGS 


H  E  A 1)  I  N  G 


MEAN  1 NG 


AGE 

ALP  HAM 
B  S  H  E  A  R 
CONG 

C  POT 


DELBED 

DENSITY 
DEPTH 
DYBED 
E/D( NEW) 


E/D(0LD) 

ELEV 

N  or  NODE 
SHR  STRENGTH 

THICKNESS 

TTHICK 

TYPE 

IJ 

V 


Age  of  a  clay  layer,  years 
Amount  of  clay  mass  erosion,  kg 
SI)  ear  stress  on  the  bed,  newtons  per  sq  in. 
Average  concentration  of  noncohesive  sediment 
in  the  water  column,  kg  per  cu  m 
Concentration  of  noncohesive  sediment  in  the 
water  column  that  would  correspond  to  full 
transport  capacity,  kg  per  cu  m 
Bed  change  since  the  beginning  of  computations, 
m 

Dry  density  of  clay  bed  layers,  kg  per  cu  m 
Water  depth,  m 

Bed  change  during  the  current  time-step 
Erosion/deposition  rate  at  the  present  time- 
step,  kg  per  sec  per  sq  m.  Positive  values 
indicate  erosion 

Erosion/deposition  rate  at  the  previous  time- 
step 

Bed  surface  elevation,  m 
Node  number 

Shear  stress  at  which  mass  erosion  of  a 

cohesive  bed  layer  occurs,  newtons  per  sq  m 
Thickness  of  a  cohesive  bed  layer,  m 
Thickness  of  a  noncohesive  bed,  m 
Clay  bed  layer  type  as  shown  on  DT  cards 
Current  speed  in  the  x-d irect ion ,  m  per  sec 
Current  speed  in  the  y-direction,  m  per  sec 


105.  Two  output  files  are  created  by  every  run  of  the  model 
and  a  third  is  also  created  if  an  extrapolation  run  is  performed. 
If  these  files  are  saved  by  job  control,  the  information  may  be 
retrieved  and  printed  by  the  postprocessors  or  subsequent  runs 
(hotstart  runs).  Table  G4  lists  the  output  files  and  their 
generic  names  (see  Appendices  N  and  0). 

10f>.  TAPE  7  contains  sediment  concenf  ration  and  cumulative 
bed  change  at  every  node,  every  time-step.  TAPE18  contains 
cohesive  bed  structure  at  every  node  for  the  final  time-step. 
These  files  are  created  by  every  model  run.  TAPE 99,  created  only 
during  extrapolation  runs,  contains  bed  elevations  at  the  end  of 
the  model  run. 


s  mm 


G  It  0 


04/85 


Table  G4 

Standard  Output  Files 


Generic 

File 

Name 

Standard 
Log i ca 1 
Unit 

Contents 

0  1S3 

7 

Conce n t r a t i on/ bed  change  results 

0  2  S  3 

99 

Extrapolated  bed  change  results 

0  3  S  3 

18 

Cohesive  bed  structure  results 

0EGK0 

1  9 

English  geometry  file 

— 

06 

Printed  output 

Job  Tracking 


107.  Keeping  track,  of  STUDH  jobs  is  made  easier  by  orderly 
methods  of  recording  jobs  and  naming  files  (see  Appendix  N).  The 
File  Management  System,  described  in  Appendix  N,  can  be  quite 
useful,  as  can  be  job  tracking  sheets  as  shown  in  Figure  C13. 
Rigorous  record  keeping  about  all  runs  made  and  their  results  is 
strongly  recommended.  Also  see  Appendix  N. 
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STUDH  JOB  TRACKING  WORKSHEET 


JOB  NAME 


DESTINATION  UN 


JOB  PRINTED 


DATE  /  /  TIME  LIMIT  (SECS) 


SUBMITTED  BY  JOB  COST 


SPECIAL  UPDATES 


TYPE  OF  RUN 


SAND  _  CLAY  _  SAND/CLAY  _ 

W /EXTRAPOLATION  PRODUCTION  TEST  ONLY  

NUMBER  OF  TIME-STEPS  TIME-STEP  (HR.)  TOTAL  SIMULATION  TIME 


JOB  DESCRIPTION 


INPUT  DATA 


RUN  CONTROL 


WATER  SURFACE 


GEOMETRY 


HOTSTART 


VELOCITIES 


OUTPUT  DATA 


CONCENTRATION/ DEL  BED 


EXTRAPOLATION 


Figure  G13.  Example  Job  Tracking  Sheet 
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NOTATION 


coefficient  for  the  source  term  1/sec 


equilibrium  concentration  portion  of  the  source 
term  kg/m^/sec 

Chez v  roughness  coefficient  ^ 

concentration  of  sediment,  kg/m 

coefficient  of  1  for  metric  units  and  1.486  for 
English  units 

critical  concentration  =  300  mg/1 

c  o  efficient  for  deposition 

coefficient  for  entrainment 
equilibrium  concentration 


approximate  concentration  in  an  element  as  evaluated 
from  the  shape  functions  and  nodal  point  values  of 
water  depth 
effective  grain  size 

effective  diffusion  coefficient  in  x -direction, 
m  2  /  s  e  c 

effective  diffusion  coefficient  in  y-direction, 
m  2  /  s  e  c 

computation  time  interval 
computation  time  interval 
time -varying  characteristic 
shear  stress  coefficient  for  currents 
shear  stress  coefficient  for  waves 


transport  potential 
transport  capacity 
acceleration  due  to  gravity 
number  of  grain  size  class 
consolidation  coefficient 
quadratic  shape  functions 
total  number  of  elements 
total  number  of  boundary  segments 
Manning's  roughness  value 
erosion  rate  constant 

percent  of  bed  surface  covered  by  grain  size, 
expressed  .is  a  function 

(  C  /  A  t  )  +«<2  ^or  transient  problem 


flux  1  ron  s o u  r  c 

e  on 

boundary  i 

water  duns  i 

t  y 

density  of 

t  h  e 

fail 

e  d 

1  a  v  e  r 

source  term 

thickness  o 
time,  see 

f  t  h 

e  fa 

i  l  e 

d  layer 

c  h  a  r  a  c  t  e  r  i  s 

tic 

time 

time  zero 

time,  1  yea 

r 

bed  share  s 

t  res 

s 

critical  s  h 

e  a  r 

s  t  re 

s  s 

for  deposition 

critical  s  h 

e  a  r 

s  t  r  e 

s  s 

for  particle  erosion 

bulk  shear 

s  t  r  e 

n  |T  t  h 

o  f 

the  layer 

<A'< 


flow  velocity  in  x-direction,  m/sec 
maximum  orbital  velocity  of  waves 
shear  velocity 

flow  velocity  in  y-direction,  m/sec 
kinematic  viscosity  of  water 
Vs/(Cc)4/3 

fall  velocity  of  a  sediment  particle 
mean  flow  velocity 
primary  flow  direction,  m 
direction  perpendicular  to  x  ,  m 
local  coordinate 
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ADDENDUM  C-  1  : 


CODING  INSTRUCTIONS  FOR  CARD  IMAGE  INPUT  DATA 


1.  A  summary  of  cards  in  this  data  set  is  shown  in  Table 
G-l-1.  A  summary  of  the  variables  is  shown  by  card  in  Table 
C-l-2  at  the  end  of  this  addendum. 

2.  Card  image  data  are  coded  in  8  0 -  column  lines  consisting 
of  10  fields  of  8  columns  each.  Blanks  are  read  as  zero  except 
where  noted  otherwise.  The  first  two  columns,  referred  to  as 
field  zero,  are  card  identifications  that  indicate  the  type  of 
data  on  that  card.  Column  1  is  the  card  group,  e.g.,  G  = 
geometry,  F  =  fluid,  etc.,  and  Column  2  is  the  data  type  within 
that  group,  e.g.,  Q  =  discharge,  N  =  Manning's  n  ,  etc.  Figure 
G-l-1  illustrates  field  numbering. 


Coding  Options  for  Nodal  Point  Data 


3.  Four  options  are  provided  for  coding  nodal  point  data. 

These  are:  (a)  constant  value  for  all  nodes,  (b)  constant  value 

by  cross  section,  (c)  value  at  each  corner  node,  and  (d)  value  at 
each  node.  Column  3  of  the  data  card  conveys  the  coding  option. 
More  than  one  option  may  be  used  provided  the  cards  are  arranged 
with  increasing  option  numbers. 

4.  Terminology  is  defined  in  Figure  G-l-2.  Cross  sections 
are  denoted  by  Roman  numerals.  Thus  cross-section  II  consists  of 
nodes  3,  7,  11,  15,  19,  23,  and  27.  Positive  directions  of  flow 
correspond  to  the  positive  x-  and  y-axes  as  shown  in  Figure 
G-l-2. 

Option  I 


5.  Coding  a  blank  in  Column  3  and  a  constant  value  in  Field 
2  causes  that  value  to  be  assigned  to  every  node.  For  example, 
"HU  1.0"  would  assign  an  x-velocity  of  1  to  every  node 

in  the  data  set.  Options  2  through  4  may  also  be  included  as 
desired,  to  change  from  the  constant  value  at  selected  locations, 
but  always  arrange  cards  in  the  sequence  of  increasing  option 
numbers. 

Option  2 


b.  Coding  an  X  in  Column  3  activates  the  cross-section 
option  (only  available  when  using  CARD  (.3  or  G4).  In  Figure  G-I- 
2,  cross  sections  are  denoted  by  Roman  numerals  I,  11,  111,  etc. 

When  coding  with  the  cross-section  option,  all  nodes  along  the 
section  are  assigned  the  constant  value.  For  example, 

"  H U  X  0.5"  would  set  x-velocity  at  0.5  at  nodes  5 ,  8  ,  13, 

lb,  21,  24,  and  29.  Values  at  mid  sect  ion  nodes,  i  .  e .  ,  those 
between  cross  sections  such  as  4,  12,  20,  28,  etc.,  are  calcu¬ 

lated  by  straight— 1 i np  interpolation  between  corner  nodes  after 
all  cross-section  data  have  been  read.  Numbering  does  riot 


G-l-1 
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FIELD 

5 

0  < 

1 

3 

2 

3 

COLUMN 

1 

2 

3 

4  5 

6 

7 

8  9 

10 

1  1 

12  13 

1  4 

1  5 

1  6 

FIELD 

3 

3 

1 

4 

5 

COLUMN 

1  7 

18 

19 

20  2  l 

22 

23 

24  25 

26 

27 

28  29 

30 

31 

32 

FIELD 

3 

5 

3 

6 

3 

COLUMN 

33 

34 

35 

36  37 

38 

39 

40  41 

42 

4  3 

44  45 

46 

47 

48 

FIELD 

1 

7 

1 

8 

3 

COLUMN 

49 

50 

5  1 

5  2  5  3 

54 

55 

56  57 

58 

59 

60  6  1 

62 

63 

64 

FIELD 

1 

9 

3 

10 

3 

COLUMN 

65 

6  6 

67 

68  69 

70 

7  1 

7  2  7  3 

74 

75 

76  7  7 

78 

79 

8  0 

Figure  G-l-1.  Field  numbering 
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have  to  be  sequential;  the  end  of  cross-section-type  data  is 
signified  by  a  blank,  zero,  or  negative  node  number.  A  new  data¬ 
type  (Column  2),  or  a  new  card-group  (Column  1)  signifies  a  new 
input  parameter. 

Option  3 

7.  Coding  a  C  in  Column  3  activates  the  corner  node  option. 

For  example,  "UUC  1.  0"  would  set  the  x- 

velocity  at  node  1  to  zero.  The  corner  node  option  may  be  used 
for  all  or  part  of  the  corner  nodes.  Numbering  does  not  have  to 
be  sequential.  All  mid-side  nodes  will  be  calculated  by 
straight-line  interpolation.  A  blank,  zero  or  negative  node 
number  signifies  the  end  of  corner  node  data  on  a  card.  A  new 
data  type  card  or  a  new  card-group  type  signifies  a  new  input 
parameter. 

Option  A 

8.  For  coding  individual  node  values,  an  N  is  placed  in 
Column  3.  Both  corner  and  raid-side  nodes  may  be  prescribed  with 
this  option.  As  in  Options  2  and  3,  numbering  does  not  have  to 
be  sequential  nor  do  all  nodes  have  to  be  included.  However, 
only  those  node  numbers  coded  will  be  assigned  a  value  with  this 
option.  A  blank,  zero,  or  negative  node  number  is  interpreted  as 
the  end  of  data. 

Coding  Date/Time  Data 

9.  On  some  data  cards,  a  provision  is  made  for  assigning  a 
date  and  time  to  the  data  that  follow.  This  information  is 
placed  in  Columns  5-8  of  Field  l  and  in  Field  2.  Columns  5-6  are 
the  last  two  digits  of  the  year.  Columns  7-8  are  the  month 
number.  Field  2  contains  the  day,  hour,  minute,  and  second  in 
two -column  digits. 

Cod ing  Values 

10.  All  values,  other  than  card  identification,  year,  and 
month,  are  read  as  real  number  variables.  If  no  decimal  is  used, 
the  data  should  be  right- justified  in  the  eight-column  field.  If 
a  decimal  is  included,  they  may  be  placed  anywhere  in  the  field. 
Unless  otherwise  noted,  only  positive  values  should  be  used. 

Where  noted  in  the  coding  instructions,  a  blank  or  zero  entry  in 

a  field  causes  default  values  to  be  assigned. 
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Continuatio  n  Cards 


II.  Some  input  data  cards  may  call  for  continuation  cards, 
for  an  example,  see  the  summary  sheet  in  Addendum  G4  for  the  DV 
card.  When  using  continuation  cards,  the  first  three  columns  are 
duplicated  on  each  card,  but  after  the  first  card,  date  and  time 
are  not  coded  and  coding  begins  in  Field  1. 


Input  Instructions 


12.  Table  G-l-1  lists  the  card  image  input  for  STUDH. 
Instructions  for  each  card  are  described  in  the  following  pages. 
Table  C-l-2  at  the  end  of  the  addendum  summarizes  input  data 
requirements. 


u 


0-1-5 


STUDH 


\ 

i- 


1 


Q 


Group 

Content 

Required? 

Page 

T  1  -  T  "5 

Title  cards 

One 

G-l-8 

SL 

Input/output  file  numbers 

No 

C-l-9 

ST 

Timing  controls 

No 

G-  1-11 

$  rt 

Hotstart  controls 

No 

G-l-16 

TR 

Trace  printout  controls 

No 

G- 1-17 

Cl 

Geometry  parameters,  general 

Yes 

G- 1 -20 

G3,  GB, 

Mesh  generator 

Yes 

G-l-22 

G  S  ,  G  K 
o  r 

G  4 

Rectangular  mesh  generator 

Yes  if  geome  try 

G- 1 -27 

GN 

Nodal  point  coordinates 

Yes  not  input 

G-  1  -28 

GY 

Bed  elevations 

Yes  on  file 

G-l-29 

GD 

Mesh  drying 

No 

G-  1  -30 

PG 

Acceleration  due  to  gravity 

No 

G-  1-31 

T2 

Time  zero 

Yes 

G-l-32 

TE 

Extrapolation  in  time 

No 

G-l-33 

TT 

Theta  for  implicitness 

No 

G-l-35 

PS 

Print  selector 

No 

C-l  -36 

S  A 

Sand  (noncohesive)  parameters 

For  sand 

G  -  1  -  3  7 

and/or 

SC 

Clay  (cohesive)  parameters 

For  clay 

G- 1 -38 

DV 

Bed  deposit  volume 

For  sand 

G  -  1  -  3  9 

1)  T 

Bed  layer  types 

No 

G- 1 -40 

DC 

Bed  layers 

Yes,  for  clay  if 
not  input  from  fi 

1  e 

G-l -42 

FT 

Fluid  temperature 

Yes 

O 

1 

1 

•e- 

OJ 

FD 

Fluid  density 

Yes 

G- 1 -44 

IIS 

Hydraulics,  shear  stress  method 

Yes 

G-l -45 

HN 

Hydraulics,  Manning's  n  values 

If  HS  ( 2 )  -  2  or 

3 

G- 1 -46 

III! 

Hydraulics,  water-surface 
elevations 

Yes 

G-l -47 

HU 

and 

Hydraulics,  x  velocity 

Yes  if  not 

input 

G-l -48 

HV 

o  r 

Hydraulics,  y  velocity 

Yes  from 

tile 

G- 1 -50 

QX 

Hydraulics,  x  discharge 

Yes 

G- 1 -52 

and 

QY 

Hydraulics,  y  discharge 

Yes 

G- 1  -  54 

KX 

Dispersion  coefficient, 
x-d irect ion 

Yes 

G-  1-56 

F.  Y 

Dispersion  coefficient, 
y-direction 

Yes 

G- 1 -58 

I  C 

Initial  conditions,  sediment 
concentrations 

Yes 

G  -  1  -  5  9 

S  K 

Sediment  size,  representative 
for  roughness 

No 

G-  1-60 

ST 

Sediment  size,  representative 
for  transport  (sand  only) 

No 

G  -  1  -  6  1 

s  mm 
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Table  G-l-1  (Concluded) 


Card  Group 

Content 

Required? 

Page 

UC 

Fall  velocity,  sediment 
part icles 

Yes 

C-l-62 

BC 

Boundary  condition,  sediment 
concentration 

Yes 

G-  1  -63 

$  SEND 

End  of  data 

Yes 

G-l-64 

IKK C J  .2) 

Printout  control ,  type  and 
timing 

Yes 

i  f  $T 

G-  1-6  5 
G-  1  -65 

1 VC0D( J  ) 

Input  velocity  field,  timing 

Yes 

cards  not 

G-l-65 

l  D  l  F  (  J  ) 

Input  dispersion  coefficients, 
timing 

Yes 

used 

C-l-65 

IDEPC( J  ) 

Input  depth  of  flow,  timing 

Yes 

G-l-65 

ISVS( J  ) 

Input  settling  velocity,  timing 

Yes 

G-l-65 

G-  1  -7 
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TI-T3CARDS  Job  Title  One  requires 

Any  number  of  T1  and  T2  cards  may  be  utilized  and  sequence  is 
not  significant  to  the  program.  But  only  one  T3  card  may  be 
included  and  it  must  be  the  last  title  card  in  the  set.  Informa¬ 
tion  from  the  T3  card  is  saved  on  the  tape  of  STUDH  results,  and 
the  program  reads  the  "3“  as  meaning  END  OF  T-CARDS. 


Field 

Variable 

Value 

Description 

Co  l  1 

1  CO 

T 

Card  group 

Co  1  2 

IDT 

1,2,3 

Data  type 

1 

IS  1 

An  y 

Coinnen  t 

2-10 

TITLE 

An  y 

Any  alpha-numeric  data  can  be  coded 

example,  stream  name,  model  name, 
study  name,  model  run  number. 


sri’Dii 
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$  L  CARD 


Input  Data  Logical  Unit  Numbers  Optional 


Card  image  data  described  in  these  pages  are  read  from  logical 
unit  (LU)  5  by  the  PRESED  module.  Module  HORSED  reads  from  a  variety 
of  logical  units  that  are  usually  disk  files.  These  files  are  either 
written  by  HR USED  or  supplied  by  another  program  (e.g.,  RMA-2V  or 
GECEN).  The  default  values  must  be  used  if  PROCLV  (Appendix  0)  is 
used. 


Field  Variable 


Value 


Descript  ion 


1 

Not  used 

1  LP 

+ 

l,U  for  standard  printed  output 

0 

Default  to  6,  line  printer 

i  INB 

+ 

LU  for  fluid  properties  data 

0 

Default  to  4 

>  INC 

+ 

LU  for  initial  and  boundary  conditions 
concent  rations 

0 

Default  to  8 

i  I ND 

+ 

LU  for  water  surface  elevations 

0 

Default  to  9 

INE 

+ 

LU  for  dispersion  coefficients 

0 

Default  to  10 

1  INF 

+ 

LU  for  water  velocities 

0 

Default  to  11 

I  NG 

+ 

LU  for  computational  mesh  geometry 

0 

Default  to  12 

1  Nil 

+ 

LU  for  bed  structure  data 

0 

Default  to  13 

CARD  NUMBER  2 

ICG 

$ 

IDT 

L 

INI 

+ 

LU  for  general  data 

0 

Default  to  14 

KPU 

+ 

LU  for  end  results  file  (Hotstart 
concentration  and  bed  elevation 
changes) 

0 

Default  to  7 

G-l 

1-9  STUD  H 

$  L  CARD  (continued) 


Field 

Variable 

Value 

Description 

4 

KPL 

- 

Not  used 

5 

I  NJ 

+ 

0 

LU  for  bed  roughness 

Default  to  1 

6 

INK 

+ 

LU  for  settling  velocities 

7 

I  NIIOT 

+ 

0 

LU  to  read  concentration  and 
hotstart  data 

Default  to  87  (hotstart  will 
if  a  $H  card  is  present) 

bed  change 

occur  only 

8 

KOHOTB 

+ 

0 

LU  to  write  clay  bed  structure  for 
subsequent  hotstart 

De  f  aul t  to  18 

9 

I  N  HOT  B 

+ 

0 

LU  to  read  hotstart  clay  bed 
Default  to  88 

structure 

(Hotstart  will  occur  only  if  a  $H  card  is  present.  Hotstart 
output  files  are  always  written.  If  they  are  desired  for  future 
use,  save  them  using  job  control.) 

C-  I  -  I  0 
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$TP  CARD  Print  Controls  Optional 

These  cards  may  be  used  instead  of  the  IFF,  etc.,  cards 
(p.  G -  1  - 6  5 ) .  They  specify  the  time-step  numbers  at  which  printed 
output  will  be  produced  ($TP)  and  at  which  particle  fall  veloci¬ 
ties  ($TF),  water  surface  elevations  ($TD),  flow  velocities 
( S  T  V ) ,  and  dispersion  coefficients  ($TC)  will  be  read  in.  The  $T 


cards 

should  be 

placed 

i  n 

the  order  shown  here. 

Field 

Variable 

Value 

Description 

Co  l  l 

l  CG 

$ 

Card  group  $  =  Command 

Co  1  2 

I  DT 

T 

Data  type  T  =  Timing  control 

Co  l  3 

ISI(  1  ) 

P 

p  =  print  timing  control 

1 

IFF 

1 

2 

3 

Print  concentration 

Print  bed  elevation  and  volume  change 
Print  both 

Fields  2-10  can  be  used  (interchangeably)  in  two  ways: 

(1)  A  single  time-step  can  be  entered  in  each  field.  This  time-step 
will  print  with  the  print  type  defined  in  Field  1. 

(2)  Three  consecutive  fields  can  be  used  to  specify  an  implied  loop 
(much  like  FORTRAN)  with  a  beginning  value,  ending  value,  and  an 
increment.  However,  the  increment  must  be  coded  in  the  third 
field  as  a  negative  number  .  The  time-steps  selected  will 

have  the  print  type  specified  in  Field  1. 

Single  fields  and  implied  loops  (three  fields)  can  be  mixed  in  Fields  2-10 
and  all  will  have  the  print  type  specified  in  Field  1. 

Repeat  $  T  P  cards  until  all  desired  output  time-steps  have  been 
selected. 


G  -  1  -  1  1 


STUDH 


$ T F  CARD 


Fall  Velocity  Input  Controls 


Optional 


These  cards  may  be  used  instead  of  the  IFF,  etc.,  cards  (p. 
C— 1—65).  They  specify  the  time-step  numbers  at  which  printed 
output  will  be  produced  (  $  T  P )  and  at  which  particle  fall  veloci¬ 
ties  ( $  T  F ) ,  water-surface  elevations  ($TD),  flow  velocities 
( S  T  V )  ,  and  dispersion  coefficients  ($TC)  will  be  read  in.  The  $T 
cards  should  be  placed  in  the  order  shown  here. 


Field 

Variable 

Value 

Description 

Co  1  1 

ICG 

$ 

Card  group  $  =  Command 

Co  1  2 

I  DT 

T 

Data  type  T  =  Timing  control 

Co  1  3 

I  S  I  (  1  ) 

F 

F  =  Fall  velocity  input 

Fields 

2-10  can  be 

used  (interchangeably)  in  two  ways: 

( 

1  )  A  single 

t ime-step 

can  be  entered  in  each  field. 

(2)  Three  consecutive  fields  can  be  used  to  specify  an  implied  loop 
(much  like  FORTRAN)  with  a  beginning  value,  ending  value,  and  an 
increment.  However,  the  increment  must  be  coded  in  the  third 
field  as  a  negat  ive  number  . 

Single  (ields  and  implied  loops  (three  fields)  can  be  mixed  in  Fields  2-10 
Repeat  STK  cards  until  all  desired  time-steps  are  specified. 


% 


$TD  CARD 


Water-Level  Input  Controls 


Optional 


These  cards  may  be  used  instead  of  the  IKK,  etc.,  cards  (p. 
G-l-65).  They  specify  the  time-step  numbers  at  which  printed 
output  will  be  produced  ($TR)  and  at  which  particle  fall  veloci¬ 
ties  ($TK),  water-surface  elevations  ( $TD) ,  flow  velocities 
($TV),  and  dispersion  coefficients  ($TC)  will  be  read  in.  The  $T 
cards  should  be  placed  in  the  order  shown  here. 


Field 

Variable 

Value 

Co  1  1 

ICC 

$ 

Co  1  2 

IDT 

T 

Co  1  3 

1  S  I  (  1  ) 

D 

_ Description 

Card  group  $  =  Command 
Data  type  T  =  Timing  control 
D  =  Water  Depths 


Fields  2-10  can  be  used  (interchangeably)  in  two  ways: 

(1)  A  single  time-step  can  be  entered  in  each  field. 

(2)  Three  consecutive  fields  can  be  used  to  specify  an  implied 
loop  (much  like  FORTRAN)  with  a  beginning  value,  ending 
value  and  an  increment.  However,  the  increment  must  be 
coded  in  the  third  field  as  a  negat  1  ve  number . 

Single  fields  and  implied  loops  (three  fields)  can  be  mixed  in 

Fields  2-10. 

Repeat  STD  cards  until  all  desired  time-steps  are  specified. 
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$TC  CARD  Dispersion  Coefficient  Input  Controls  Optional 

These  cards  may  be  used  instead  of  the  IFF,  etc.,  cards  (p. 
G_l_65).  They  specify  the  time-step  numbers  at  which  printed 
output  will  be  produced  ($TP)  and  at  which  particle  fall  veloci¬ 
ties  ($TF) ,  water-surface  elevations  ( $TD) ,  flow  velocities 
($TV),  and  dispersion  coefficients  ($TC)  will  be  read  in.  The  $T 
cards  should  be  placed  in  the  order  shown  here. 


Field 

Variable 

Value 

Description 

Co  1 

1 

ICG 

S 

Card  group  $  =  Command 

Co  1 

2 

IDT 

T 

Data  type  T  =  Timing  control 

Co  1 

3 

ISI(l) 

C 

C  =  Concentration  input 

Fields  2-10  can  be  used  (interchangeably)  in  two  ways: 

(1)  A  single  time-step  can  be  entered  in  each  field. 

(2)  Three  consecutive  fields  can  be  used  to  specify  an  implied  loop 
(much  like  FORTRAN)  with  a  beginning  value,  ending  value,  and  an 
increment.  However,  the  increment  must  be  coded  in  the  third 
field  as  a  negative  number. 

Single  fields  and  Implied  loops  (three  fields)  can  be  mixed  in  Fields  2-10 
Repeat  $TC  cards  until  all  desired  time-steps  are  specified. 


sTunii 


0-1-14 


$TV  CARD 


Velocity  Input  Controls 


Opt lonal 


These  cards  may  be  used  instead  of  the  IFF,  etc.,  cards  (p. 
G- 1-65).  They  specify  the  time-step  numbers  at  which  printed 
output  will  be  produced  ($TP)  and  at  which  particle  fall  veloci¬ 
ties  ($TF),  water-surface  elevations  ($TD),  flow  velocities 
($TV),  and  dispersion  coefficients  ($TC)  will  be  read  in.  The  $T 
cards  should  be  placed  in  the  order  shown  here. 


Field 

Variable 

Value 

Description 

Co  1  1 

rcc 

$ 

Card  group  $ 

*  Command 

Col  2 

IDT 

T 

Data  type  T  = 

Timing  control 

Col  3 

ISKI) 

V 

V  =  Velocity 

input 

Fields  2 

-10  can  be 

used  (interchangeably) 

in  t wo  ways: 

(  1  ) 

A  single 

t ime-step 

can  be  entered 

in  each  field  . 

(2)  Three  consecutive  fields  can  be  used  to  specify  an  implied  loop 
(much  like  FORTRAN)  with  a  beginning  value,  ending  value,  and  an 
increment.  However,  the  increment  must  be  coded  in  the  third 
field  as  a  negat 1 ve  number . 

Single  fields  and  Implied  loops  (three  fields)  can  be  mixed  in  Fields  2-10 
Repeat  $TV  cards  until  all  desired  time-steps  are  specified. 
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$  H  CARD 


Hotstart  Controls 


Optional 


The  parameters  on  this  card  cause  the  program  to  begin  with 
values  computed  at  the  end  of  a  previous  model  run,  thus 
continuing  the  computations  of  the  previous  run  (hotstart).  The 
previous  run  must  have  saved  output  of  the  desired  parameters. 


Field  Variable  Value 


Description 


0  ICG 

IDT 

2  KCHOT 

3  KDBHOT 

4  KBSHOT 


$ 

H 

+  Hotstart  concentrations  using  those  from 

last  time-step  of  previous  run. 

0  No  concentration  hotstart. 

+  Hotstart  net  bed  change  (DELBED)  using 

last  time-step  of  previous  run 

0  No  DELBED  hotstart 

+  Hotstart  bed  structure  (thickness  of 

layers,  etc.)  using  last  time-step  of 
previous  run  for  clay  and  mixed  beds. 

0  No  bed  structure  hotstart 


STUD  H 
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T  R  C  A  R  D  Trace  Printout  Optional 

Note:  Use  a  continuation  card  to  define  trace  variables 

K  S  W (  1  1 )  —  K  S  W ( 20) . 


Field 

Variable 

Value 

Descri pt  ion 

0 

ICG 

T 

T  =  Card  group 

IDT 

R 

R  =  Data  type 

1 

I  ECHO 

-  1 

0 

+  l 
+  2 

No  printout  of  input  data  cards 

Print  out  each  input  card  as  it  is  read  in 

In  addition  to  input,  print  F K  mesh 

In  addition  to  above,  list  boundary  nodes 
and  Data  Set  Codes. 

2 

KSW( 2) 

0 

1 

2 

No  trace  printout  in  Subroutine  GRIDGR 

Print  NKTNP  (1st  and  last  node  on  x-section) 
In  addition  to  above,  print  F K  mesh 

3 

KSW( 3) 

0 

1 

No  trace  printout  in  Subroutine  BEDS UR  or 
in  BEDXCG. 

Print  the  following  in  BKDSUR:  Node, 

u-velocity,  v-velocity,  bed  exchange  rate 
at  beginning  of  computation  time  interval, 
bed  exchange  rate  at  end  of  computation 
time  interval  (kg/m3  sec),  change  in  bed 

elevation  during  computation  interval, 
mass  erosion  rate,  bed  elevation,  and  bed 
shear  stress  ( newtons/ sq  m). 

Plus  the  following  from  Subroutine  BEDXCG: 
Node,  u-velocity,  v-velocity,  water  depth, 
depth  of  sand  in  bed,  suspended  load  con¬ 
centration  potential  transport  (kg/mO, 
bed  elevations,  alphal,  and  alpha2. 

Print  the  following  in  BKDSUR:  Node, 

layer  No.,  layer  type,  layer  thickness  (m' 
layer  density  (kg/cu  m),  layer  strength 


(N/SM),  laye 

r  ag 

e  (yr), 

and 

change 

in  bed 

elevation  (m 

)  at 

each  t 

i  me-s 

t  e  p  . 

-2 

Same  as  above 

for 

initial 

c  on  d 

i t i on  s 

only 

3 

Print  both  Opt 

ions 

1  and 

2  1  n 

BEDSUR 

a  t 

each  time -step 

• 

-3 

Same  as  above 

for 

Initial 

c  o  n  d 

i  t  i  o  n  s 

only. 
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T  R  Card  (Continued) 

Field  Variable  Value  _ Description _ 

4  KSW(4)  0  No  trace  printout  in  Subroutine  ELSTIF2. 

1  Print  Element  Shape  Function  coefficients 

and  their  derivatives. 

5  KSW(5)  0  No  trace  printout  in  Subroutine  AWH1TE 

and  its  interface  SANDX. 

1  Print  the  following  SANDX:  Node,  D35, 

velocity  vector,  depth  of  water,  bed  shear 
stress,  water  density,  kinematic  viscosity 
of  water,  sediment  concentration. 

Plus  the  following  from  AWHITE:  Size 

class  number,  grain  size,  and  the  Ackers- 
White  coefficients  ( DGR  ,  AWN,  AWA ,  AWM  , 

AWC  ,  USTFG,  USTCG  ,  FGR  ,  GCR,  CBAR ) . 

6  KSW(6)  0  No  trace  printout  in  Subroutine  HORSED. 

1  Print  Initial  Conditions  Data  by  node. 

2  In  addition  to  the  above,  print  element 

data  . 

3  In  addition  to  above,  print  nodal  point  co¬ 

ordinates  and  the  element  connections  table. 

7  KSW( 7 )  0  No  trace  printout  in  Subroutine  ONEDIN. 

1  Trace  array  sizes  and  data  set  codes. 

8  KSW(8)  0  No  trace  printout  in  Subroutine  CLASS. 

1  Print  class  interval  data. 

9  KS  W  (  9 )  0  No  trace  printout  in  Subroutine  DEPTH. 

-1  Print  out  water  depths  for  initial 

cond i t i ons  . 

+1  Print  out  water  depths  at  each  time-step. 

10  KSW(10)  0  No  trace  printout  in  Subroutine  D1FC0F. 

-1  Print  Diffusion  Coefficients  for  initial 

conditions. 

+  1  Print  dll  fusion  coefficients  for  each  time 

step. 


S  ITDH 
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TR  CARD  (Continued) 


Variable  Value 


Description 


KSW(  1  1  ) 


KSW(  I  2  ) 


KSW( 1 3) 


KSW(  I  4  ) 


KSW(  1 3  ) 


0  No  trace  printout  in  Subroutine  INFUTV 

-1  Print  u  -  arid  v-velocity  components  for 

Initial  Conditions. 

I  Print  velocity  components  for  each  time- 

step. 

0  No  trace  printout  in  Subroutine  SETVEL. 

-1  Print  settling  velocity  of  particles  for 

initial  conditions. 

+1  Print  settling  velocities  for  each  time 

step. 

0  No  trace  printout  in  Subroutine  EXTRAP. 

1  Trace  printout  of  extrapolation 

coeff icients. 

0  No  trace  printout  in  Subroutine  JONFW. 

1  Wave  particle  orbit  length,  wave  velocity 

and  current  velocity  near  the  bed,  wave 
Reynolds  no.  and  wave  friction  factor. 

0  No  trace  printout  in  subroutine  DRY NOD. 

1  Print  out  list  of  dry  nodes  and  elements. 
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Cl  CARD 

Field 

0 

2 

3 

4 

5 

6 

7 

8 

9 

ST  I' OH 


Required 


General  description  of  the  finite  element  network. 


Variable  Value 


Description 


I  CC  ,  IDT 
1  HV 


UM  I  LF. 


DMILE 


XS  C ALE 


YSCALE 


NF, 


NP 


NPX 


Cl  Card  identification  begins  in  Column  1 

0  Data  set  is  for  Horizontal  Model 

(only  option  at  present). 

1  Data  set  Is  for  Vertical  Model 

-,0,+  Identifies  the  upstream  limit  of  study 
area  by  river  mile.  If  'his  value  is 
omitted,  the  program  defaults  to  0. 

-  ,  0  ,  +  Identifies  the  downstream  limit  of  study 
area  by  river  mile.  If  this  value  is 
omitted,  the  program  defaults  to  0. 

+  The  X-coordinates  will  be  multiplied  by 

variable  to  scale  from  map  to  prototype 
size. 

0  The  program  defaults  to  1.0. 

+  The  Y-coo r d i n a t e s  will  be  multiplied  by 

variable  to  scale  from  map  to  prototype 
size. 

0  The  program  defaults  to  1.0 

0,+  Enter  the  number  of  elements  in  the  finite 

element  network  when  reading  in  the  compu¬ 
tation  mesh  from  cards  or  from  a  previously 
generated  tape  file.  Leave  blank  when 
networks  are  to  be  generated  by  the  pro¬ 
ram  Subroutines  RGRID  or  GRID. 

0  ,  +  Enter  the  number  of  node  points  when  read¬ 
ing  the  finite  element  network  from  cards 
or  a  previously  generated  tape  file.  It 
may  be  left  blank  when  the  network  is  being 
computed  in  Subroutines  GRID  or  RGRID. 

0,+  Enter  the  number  or  corner  nodes  when 

reading  the  finite  element  network  from 
cards.  This  variable  should  be  used  in 
conjunction  with  NE  and  NP  variables  above. 
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G 1  CARD  (Continued) 


Field  Variable  Value  _ Descript  ion 


10  MKTR1C  0  The  computer  program  expects  all  input 

data  to  be  in  metric  units. 

*1  The  computer  program  expects  all  input 

data  to  be  in  English  units.  It  is  con¬ 
verted  into  metric  units  immediately  upon 
reading  and  all  computations  and  output 
are  produced  in  metric  units. 


*  Not  yet  available. 
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G1  CARD 

This  card 


is  required 


Mesh  Generator 
to  use  the  internal 


Optional 
mesh  generator. 


Field  Variable  Value 


0  ICG, IDT  G  3 

2  WTLMAX  0 


_ Description _ 

Card  identification  begins  in  Column  1 

The  program  will  default  to  a  fully  iso¬ 
parametric  computation  mesh. 


1  The  program  will  use  a  LAPLACF.  approxima¬ 

tion  to  the  isoparametric  mesh. 


3  *  W  I  D  T  H 


0  Vertical  model  width.  Values  are  coded  on 

GW  cards. 


+  The  program  will  assign  this  width  to  all 

nodes.  It  can  be  modified  at  any  or  all 
cross  sections  or  nodes  (see  Options  GWX 
or  GWN  cards)  if  desired. 

4  DEPTH  0  Horizontal  model  options.  Depth  will  be 

calculated  from  water  surface  (HH-Cards) 
minus  bed  surface  elevations  (GY-Cards). 
Ignore  this  variable  when  coding  for  ver¬ 
tical  modes. 


+  The  program  will  assign  this  constant 

depth  to  all  nodes  plus  modify  it  at  se¬ 
lected  modes  if  desired  (HHN  and  GYN-cards) 

Total  nodes  =  3*NF.  +  2  (NPAN  +  NXS)  -  1. 


1 


*  Not  used. 
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OB  CARD 

Mesh 

Generator  (Continued)  Required  if 

G3  card  is  present 

Code  XY  coordinates  on  this  card  to  prescribe  the  outside 
boundary  geometry  and  all  interior  nodes  will  be  calculated  automati¬ 
cally.  The  program  assumes  the  coordinate  on  this  GB  card  is  connected 

to  the  coordinate  on  the  previous  GB  card  if  an  INCR  value  (GB-b)  is 
entered.  In  addition,  GB  cards  can  be  used  to  "fix”  the  location  of  any 

coordinates,  thereby  overriding  the  automatic  computations. 

K  i  e  1  d 

Variable 

Value 

Description 

0 

I CR , 1 DT 

GB 

Card  identification  begins  in  Column  1 

2 

K  M  11.  K 

This  variable  is  optional.  It  is  convenient 

to  identify  cross  sections  by  river  mile 
when  mesh  points  are  aligned  in  a  systematic 
fashion  across  the  river  or  estuary. 

3 

N 

+ 

The  node  point  number  for  each  new  node. 

- 

The  number  has  already  been  read  on  GB 
cards. 

4 

XV 

0  ,  + 

When  N  is  positive,  enter  the  X-coordinate 
of  the  node. 

3 

Y  V 

-  ,  0  ,  + 

The  y-coordinate  of  the  node. 

h 

INCR 

- ,  + 

The  numbering  increment  between  corner 
nodes  from  the  previous  G B  c a r d  to  this 
one  segment.  Knter  a  negative  value  it 
node  numbers  are  decreasing. 

0 

Do  not  enter  a  numbering  increment  for  the 
first  nodal  point.  Do  not  enter  an  INCR 

when  simply  prescribing  (freezing)  the 
location  of  a  node. 

7 

1  NCR  2 

-,+ 

The  numbering  increment  between  the  corner 
node  and  midpoint  node  along  a  circular 
arc. 

0 

When  not  using  a  circular  arc. 

« 

D 

II 

Corner  nodes  are  spaced  e  q  u  i  d i s  L  a  n c e  apart 
on  this  segment  of  the  boundary  (i.e.,  ail 
elements  are  the  same  size). 

+ 

inter  the  ratio  tor  changing  element  size 
along  this  boundary.  Values  greater  than 

1.0  increase  the  size.  Values  between  1 

a nd  0  decrease  the  si  z  e  . 

- 

Do  not  use. 

G- 
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GB  CARD  (Continued) 


Field  Variable 


Value 


Description 


Leave  this  value  blank  for  a  straight  line 

A  point  on  a  circular  arc  which  is  not  an 
end  point.  Do  not  use  (0,0)  for  (XC.YC) 
because  program  will  treat  it  as  a  blank 

Leave  this  value  blank  for  a  straight  line 


The  companion  to  XC  (GB-9).  Do  not  use 
(0,0)  for  (XC.YC). 


S  IT  Dll 
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GS  CARD 


Mesh  Generator  (Continued) 


Required  if 

G  3  card  is 
present 


The  parameters  on  this  card  prescribe  the  number  of  elements  along 
as  well  as  across  the  computation  mesh.  One  GK  card  must  follow  to  de¬ 
scribe  element  connections. 


Field  Variable 


1CB , IDT 
NXS 


N  P  AN 

INCRP 


NBF.L 


Value 

GS 


_ Description _ 

Card  identification  begins  in  Column  1 

The  total  number  of  cross  sections  along 
the  computational  space  described  by  the 
following  CK  card.  It  includes  both  end 
sections  in  that  space.  Do  not  count  mid¬ 
side  nodes  as  cross  sections. 

The  number  of  panels  (i.e.,  elements) 

across  the  computational  space.  In  terms 
of  backwater  notation,  NPAN  would  be  the 
number  of  subsections  at  a  cross  section. 

Increment  for  calculating  nodal  point  num¬ 
bers  around  each  tier  of  elements  in  this 
computational  space.  If  left  blank,  the 
program  will  calculate  INCRP  as  follows. 
INCRP  =  3  *  NPAN  +  2. 

Connect  meshes. 

Base  element  number  for  first  tier. 

Numbering  increment  from  base  element  to 
adjoining  element. 


DKLKL 


Ct  CARD 


Mesh  Generator  (Continued) 


Required  if 
G3  card  is 
present 


The  parameters  on  this  card  connect  the  nodes  prescribed  on  GB 
cards  Into  the  sequence  of  elements  which  forms  the  finite  element  com¬ 
putation  mesh. 


Field  Variable  Value 


Description 


0  1CB.IDT 

2  NT  F. 

3  N  0  D  P  (  1  ) 


4  N  0  D  P  (  2  ) 

3  N  0  D  P  (  3  ) 

b  NOD  P ( 4 ) 

7  N  0  D  P  (  5  ) 

B  Nl)DP(b) 

9  N  0  D  P  (  7  ) 


GK  Card  identification  in  Column  1 

+  Code  the  element  number 

0  The  program  will  default  to  element  num¬ 

ber  1.  NTK  is  the  number  of  the  element 
whose  nodes  are  specified  on  this  card. 

+  This  is  the  first  of  eight  nodal  point 

numbers  which  describe  the  element  NTE. 

It  must  be  the  lowest  numbered  corner  node 
at  the  outer  edge  of  the  element. 

"Connect  Meshes"  option  only.  Code  Node  1 
as  a  negative  if  changing  direction  from 
previously  generated  mesh. 

+  Proceed  counterclockwise  around  the  ele¬ 

ment.  See  Field  3  description  for  details 
Negative  nodes  not  permitted  unless  indi¬ 
cated  in  the  Value  Column. 


+ 


+ 


+ 


+ 


10  N  0  D  P ( 8  )  + 


K- 


s  mm 
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G4  CARD  Rectangular  Mesh  Generator 

The  parameters  on  this  card  are  only  required  if  using  the  rec¬ 
tangular  mesh  generator. 


I# 


Field  Variable 


0  ICG, IDT 

2  TML 


3  *  W  I  D  T  H 


4  OF.  PTH 


3  NXS 


6  NP  AN 

7  XR 


8  YR 

*  Not  used. 


Value 


Descriptio n 


G4  Card  identification  begins  in  Column  1 

0  The  program  will  default  to  the  distance 

between  UMILF.  and  DM  ILF  shown  on  Card  Cl. 
If  these  were  not  prescribed,  TML  must  be 
entered  on  this  card  as  follows: 

+  Total  model  length  in  metres. 

When  a  constant  width  geometry  is  desired 
in  the  vertical  model. 

+  Enter  the  value  here. 

0  The  program  will  look  for  CW-cards. 

When  a  constant  depth  geometry  is  desired 
in  the  horizontal  model. 

+  The  program  will  subtract  this  value  from 

the  water  surface  elevation  at  all  nodes 
to  determine  the  bed  surface  elevation. 

0  The  program  will  expect  bed  surface  eleva¬ 

tions  to  be  entered  on  GY-cards. 

+  The  total  number  of  cross  sections  in  the 

computation  mesh.  This  includes  one  at 
each  end  boundary.  Do  not  count  mid-side 
nodes  as  cross  sections. 

+  The  total  number  of  elements  across  each 

cross  section. 

0  The  program  will  use  uniform  spacing  in 

the  x-direction  for  calculating  the  dis¬ 
tance  between  corner  nodes. 

+  For  values  greater  than  1,  the  length  will 

increase  in  the  x-direction.  For  values 
between  0  and  I,  the  length  will  decrease 
in  the  x-direction. 

Same  as  XR  except  in  the  y-  or  z -directi  on. 
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GN  Card  Nodal  Point  Coordinates  Optional 

The  coordinate  of  nodal  points  can  be  prescribed  on  GN  cards  by 
coding  the  (x,y)  values  at  each  corner  node.  When  this  option  is 
selected,  a  G E  card  is  required  for  each  element  and  only  coding 
Options  1,  4,  and  5  are  permitted  for  all  other  input  parameters. 

Code  3  points  per  card.  Omit  GN  cards  if  geometry  is  attached  on  an 
external  file.  Begin  continuation  card  in  Field  2. 


Field  Variable  Value 

Col  1  ICG  G 

Col  2  IDT  C 

2  Node  + 

3  X  + 

4  Y  + 

5  Node  + 


Note  that  data  on  these 
external  geometry  file. 


_ Description _ 

Card  group  G  =  geometric  data. 

Data  type  C  =  corner  nodes. 

Code  the  nodal  point  number. 

Code  the  x- c oo r d i n a t e  . 

Code  the  y -c oo r d i na t e  . 

Repeat  (NODE,  X,  Y)  for  3  points  per 
card. 

cards  will  not  override  data  on  an 


sir  mi 
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GY  CARD  Initial  Bed  Elevations  Optional 

When  coding  more  than  one  time  point,  enter  the  YEAR/ MONTH / DAY / 

HO  (JR/ MINUTE/SECOND  for  each  successive  time  using  the  format  for  the 
first  one.  If  two  or  more  options  are  used  for  coding  this  data  type, 
stack  the  cards  in  the  order  shown  for  Col  3  below. 

Field  Variable  Value  _ Description _ 

Col  1  ICG  G  Card  group  G  =  Geometry. 

Col  2  IDT  Y  Data  type  Y  =  Bed  elevation. 

Co t  3  ISI,  Coding  options. 

Blank  =  constant  value  for  all  nodes. 

X  X  =  constant  for  this  cross  section. 


C  C  =  value  at  corner  node  only. 

N  N  =  value  by  node. 


Col  5-b 

YEAR 

+ 

Code 

t  he 

last  two  digits  of  the  year. 

Col  7-8 

MONTH 

+ 

Code 

the 

month  number  (01-12). 

2 

DAY 

+ 

Code 

the 

DAY,  HOUR,  MINUTE  AND  SECOND  for 

HOUR 

+ 

this  event.  Use  2  columns  for  each 

M I NUTE 

+ 

(01 

-31  ) 

(01-60),  etc. 

SECOND 

+ 

3 

LOC 

4- 

Co  d  e 

the 

locator  for  ELF.Vi 

for  #  option  -  LOC  =  1 

for  X  option  -  LOC  =  cross-section  number 

for  C  option  -  LOC  =  corner  node  number 

for  N  option  -  LOC  =  node  number. 


4 

ELEV  i 

+ 

Code  the 

bed  elevation  in 

metres  . 

3 

L0C2 

+ 

Code  the 

locator  for  Kl.E  V  2 

• 

6 

elev2 

+ 

Code  the  bed  elevation  for 
X-Section  LOC2. 

node  or 

(7-10) 

etc. 

Use  all 

10  fields... start 

continual  ion 

cards  in  Field  1  and  do  NOT  code  date/ time 
Leave  at  least  one  blank  LO C-tie Id  at  the 
end  of  data  even  if  it  requires  an  addi¬ 
tional  card. 

Note:  LOC  j  >  LOC  2  ,  etc.,  do  not  have  to  be 

sequential 

Note  that  data  specified  on  these  cards  will  not  override  data  on 
an  external  geometry  file. 
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GDCARD  Mesh  Drying  Optional 


Field 

Variable 

Value 

Description 

Co  1  1 

ICG 

G 

Card 

group 

G  =  geometry. 

Co  1  2 

IDT 

D 

Data 

type 

D  =  drying. 

2 

I  DRY 

0 

Default. 

Depths  are  not  checked  for  dry 

nodes. 

+  Depths  are  checked  for  dry  nodes  and  ele¬ 

ments  and  those  with  depth  less  than  DSETD 
are  excluded  from  computations. 

3  DSETD  +  Critical  water  depth  for  node  to  be 

considered  dry. 

Default  is  0.1219  M 

(This  should  have  the  metric 
equivalent  to  DSETD  used  in  the  R  M  A  -  2  V 
run  supplying  hydrodynamic  data  to 
this  run). 


4  DRYEXP  0  Default.  All  nodes  are  considered  in  the 

extrapolation  computations,  regardless 
of  depth  . 


+  Water  depth  below  which  the  extrapolation 

limit  EXPDMX  (p.  G26)  is  disabled  to 

prevent  very  shallow  or  dry  areas  from 
dominating  the  extrapolation. 


ST  UDH 


G- 1-30 


(J  A  /  rf  5 


PC  CARD  Physical  Properties  (acce  ration  of  gravity)  Optional 

The  program  defaults  to  standard  acceleration  of  gravity  at 
45  deg  latitude  and  sea-level  elevation,  which  is  9.801  mps  ^ .  If 
refinement  is  needed  to  other  latitudes,  elevations,  or  planets, 
code  as  shown  below. 


Field 

Variable 

Value 

Description 

0 

ICC,  1 DT 

PC 

Card  group  =  P  (physical  properties). 

Data  type  =  G  (acceleration  due  to  gravity) 

2 

ACC  R 

0 

Acceleration  due  to  gravity 
second  . 

Default  value  is  9.802  m  /  s  2 

in  metres  per 

(32.174  fps2). 

I 


PH 


C-l-31 
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TZ  CARDS  Computation  Time  Required 


Field 

Variable 

Value 

Descript  ion 

Col  1 

ICG 

T 

Card  group  T  «  Time. 

Col  2 

IDT 

Z 

Data  type  Z  =  zero. 

2 

YEAR 

+ 

Code  the  starting  year  for  this 
calculation  (four  digits). 

3 

MONTH 

+ 

Code  the  month  number. 

4 

DAY 

+ 

Code  the  day . 

5 

HOUR 

+ 

Use  two  columns  for  each  starting  in 

MINUTE 

SECOND 

+ 

+ 

Co  1 urn  n  3  5. 

6 

DT 

+ 

Code  the  computation  interval  length  in 
seconds  (required). 

7 

NTTS 

+ 

Code  the  number  of  computation  intervals 
for  this  job. 

STUD  H 
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T  K  CARD  Extrapolation  in  Time  Optional 

The  parameters  on  this  card  are  only  required  if  using  the 
Extrapolation-in- Time  option. 


Field 

Variable 

Value 

Descr  i  pt ion 

0 

ICG , IDT 

TE 

Card  identification  begins  in  Column  1. 

2 

I  DLB 

99 

Logical  unit  on  which  previous  extrapolation 
results  are  stored  and  read  in  as  initial 
condi t ion. 

0 

No  previous  extrapolation. 

3 

MKX 

+ 

Maximum  number  of  time -stepping  cycles. 

Used  to  prevent  runaway  costs.  Ttiis 

parameter  should  not  be  used  to  control 
extrapolation  time. 

4 

TIMEX 

+ 

Starting  time  of  this  simulation  in 
seconds . 

5 

EXDYMX 

+ 

Maximum  permissible  bed  elevation  change 

during  the  extrapolation,  metres.  This  is 
the  first  of  three  constraints  used  by 
EXTRAP  to  compute  permissible  extrapola¬ 
tion  time. 

6 

EXPUMX 

+ 

Maximum  permissible  bed  elevation  change 
expressed  as  a  percent  of  water  depth. 

This  is  the  second  of  three  constraints 
used  by  EXTRAP  to  compute  the  permissible 
extrapolation  time. 

7 

EXDT 

+ 

End-of-run  time  (seconds)  is  the  third  of 
three  constraints)  and  ultimate  const  taint 
used  to  control  the  maximum  permissible 
extrapolation  time. 

8 

ZETA 

+ 

Implicitness  factor.  ZETA  can  range  be¬ 

tween  0.000001  and  1.0  in  selecting  the 
Influence  of  history  on  extrapolation  rate. 

0 

Defaults  to  1.0  =  most  recent  simulation 
rate  is  used  and  all  prior  simulation 
rates  are  disregarded. 

9 

N0N0D 

+ 

Number  of  nodes  at  which  deptli  limits  must 
be  exceeded  before  extrapolation  is  stopped 

0 

Default  is  one  node. 
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TK  CARD 


Extrapolation  in  Tiie  (Continued) 


Field  Variable 


10  MTEX 


Value  Description 


1  Clay  or  mixed  bed  extrapolation  approach 

control.  1  =  bed  layer  structure  is  con 
sidered  during  extrapolation  using  the 
same  model  as  subroutine  BEDSUR. 


Bed  layer  structure  is  not  considered  or 
changed  by  extrapolation.  Only  bed  ele¬ 
vations  are  changed,  except  erosion  is 
limited  to  thickness  of  sediment  in  bed, 


The  extrapolation  routine  takes  the  results  of  the  real-time  compu 
tations  and  extends  them  forward  in  time  without  recalculating  the  ero¬ 
sion  and  deposition  at  each  time-step.  At  intervals,  it  stops  and  de¬ 
tailed  calculations  are  resumed  befot  e  subsequent  extrapolations  are 
made  . 

EXDYMX  and  EXPDMX  are  used  to  control  the  maximum  bed  change  that 
can  occur  in  an  extrapolation  period.  EXDT  is  the  total  simulation 
time  that  is  desired.  HEX  limits  the  number  of  real-time  simulations 
that  are  used  in  an  extrapolation  sequence.  Used  to  prevent  runaway 
costs,  it  may  halt  an  extrapolation  run  before  EXDT  is  reached. 

In  applications  where  wetting  and  drying  is  occuring,  successful 
extrapolation  may  require  use  of  the  DRYKXP  variables  on  the  GD  card 
(p.  G-l-30). 
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TT  CARO 


Crank-Nicholson  THETA 


Opt iona i 


Field 

Variable 

Value 

Description 

Co  1  1 

ICG 

T 

Card 

group  T  =  t ime . 

Co  1  2 

IDT 

r 

Da  t  a 

type  T  =  Theta. 

2 

TETA* 

0.5 

This 

produces  the  most  sensitive  model  re 

sponse  but  often  causes  computations  to 
oscillate. 


1.0  This  produces  the  least  sensitive  model 

response  and  often  smooths  results  too 
much. 

0  The  default  value  is  0.5. 


■'Recommended  value  =  0.66 


0-1-35 


STHDH 


PS  CARD  Selective  Printout  Optional 

Print,  normal  and  trace  options  may  be  restricted  to  preselected 
elements. 


Field  Variable  Value 


Description 


0 

ICG 

P 

Card  group  P 

=  print  out 

controls. 

I  DT 

S 

Data  type  S  = 
e 1 eme  n  t . 

selective 

locations  by 

l 

IHAVC 

+ 

Code  the  element  number.  Values  may  be  in 

any  order  and  embedded  blank  fields  are 
permissible. 

2 

IHAVK2 

+ 

Continue  coding  values,  using  continuation 
PS- Cards,  until  all  desired  locations  are 
specified. 

STUDH 
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SA  CARO  Sediment  Size  Classes,  Noncohesive  Optional 

(Required  for  sand 
bed  problems) 

Note:  Use  only  1  grain  size  at  present.  Code  SANOL  =  SANDU 

and  CLASSA  =  1 


Field 

Variable 

Value 

De script  ion 

0 

SA 

Card  group  =  S  (sediment  size  classes). 

2 

MTC 

-- 

Oe fault  is  not  available. 

7 

Ackers-White  transport  function. 

3 

SANOL 

0 

Oefault  for  minimum  size  is  0.0625  mm. 

+ 

Enter  desired  value  in  mm. 

4 

SANOU 

0 

Oefault  tor  maximum  size  is  2  mm. 

+ 

Enter  desired  value  in  mm. 

5 

CLASSA 

0 

Default  is  1  class. 

+ 

Enter  the  desired  number.  The  class  in¬ 
terval  is  calculated  for  the  log  of  par¬ 
ticular  sizes. 

6 

SCS  A 

0 

Default  specific  gravity  2.65. 

+ 

Enter  the  desired  specific  gravity  of  sand 
grains. 

7 

GSF 

0 

Default  grain  shape  factor  is  0.7. 

+ 

Enter  the  desired  grain  shape  factor. 

8 

CLUB 

0 

Oefault  characteristic  length  factor  for 
deposition  is  1.0  (times  depth). 

+ 

Enter  the  desired  factor. 

9 

CLER 

0 

Oefault  characteristic  length  factor 
for  erosion  is  10.0  (times  depth). 

+ 

Enter  the  desired  factor. 
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SC  CARD 


Sediment  Characteristics,  Cohesive 


Opt ional 
( Required  for 
cohesive  bed 
probl ems  ) 


Field  Variable  Value  _ Description 


0 

SC 

Card  group  =  S. 

2 

MX  CL 

0 

Default  not  available. 

l 

Original  Krone  and  Partheniades  equations 
for  deposition  and  erosion. 

3 

TAUCD 

0 

Default  for  critical  shear  stress  for 
deposition  is  0.06  newtons/™^. 

+ 

Enter  desired  value  in  newtons/m^. 

4 

KR0DCP 

0 

Default  for  critical  shear  stress  for 
particle  erosion  is  0.06  newtons/m^. 

+ 

Enter  desired  value  in  newtons/m^. 

3 

ER0C0N 

0 

Default  for  constant  in  erosion  equation 
is  0.002  kg/m^/sec. 

+ 

Enter  desired  value. 

6 

SC.G  L 

0 

Default  for  specific  gravity  of  clay 
particles  is  2.65. 

7 

MNCL 

0 

Default  for  maximum  number  of  consolidating 
layers  =  4  . 

+ 

Enter  desired  value.  It  must  be  less  than 

LNBL  which  is  preset  to  ID. 


>1010:  For  mixed  sand  and  clay  bed  runs,  both  SA  and  SC  cards  are  re¬ 
quired.  The  separate  sand/clay  runs  are  performed  in  the  sequence 
in  which  these  two  cards  appear. 


DV  CARD 


Volume  of  Sand  Bed  Sediment 


Required  for 
sand  only  runs 


When  coding  more  than  one  time  point,  enter  the  YEAR/MONTH/ DAY/ 
HOUR/MINUTE/SECOND  for  each  successive  time  using  the  format  for  the 
first  one.  It  two  or  more  options  are  used  for  coding  this  data  type, 
stack  the  cards  in  the  order  shown  for  Column  3  below. 


K  i  e  1  d 


Variable 


Value 


Description 


Card  group  D  =  bed  deposit 


Co  1  2 


Data  type  V  =  Volume  of  sediment  reservoir 


Col  3 


Coding  options 


Blank  =  constant  value  for  all  nodes 


X  =  constant  for  this  cross  section 


C  =  value  at  corner  nodes  only 


N  =  value  by  node 


Co  1  5-6  Year 


Code  the  last  two  digits  of  the  year 


Col  7-8  MONTH 


Code  the  month  number  (01-12) 


DAY 

HOUR 

MINUTE 

SECOND 


Code  the  DAY,  HOUR,  MINUTE,  and  SECOND  for 
this  event.  Use  two  columns  each  (01-31) 
(01-60),  etc. 


Code  the  locator  for  TTHICKj 
tor  $  option  -  LOC  =  1 

tor  X  option  -  LOC  =  cross-section  number 

for  C  option  -  LOC  =  corner  node  number 

for  N  option  -  LOC  =  node  number 


(7-10) 


T  T  H  I  C  K  i 


TTH I CK  2 


Code  depth  of  sediment  layer  in  meters 

Code  the  locator  for  TTHICK2 

Code  the  depth  of  sediment  at  LOC? 

Use  all  10  fields.  ..start  continuation 

cards  in  Field  1  and  do  NOT  code  date/time 
Leave  at  least  1  h  1  a n  k  L  O  C - f i e 1 d  at  the 
end  of  data  e  v  e  n  if  it  requires  an  addi¬ 
tional  card. 


G- 1-39 


t)T  CARD 


Characteristic  Deposit 
by  Type  of  Cohesive  Material 


Opt ional 


Each  node  can  be  assigned  up  to  10  layers  for  describing  the  char¬ 
acteristics  of  the  initial,  cohesive  (siLt  or  clay)  (DC-card)  bed  de¬ 
posits.  Each  layer  is  assigned  a  "type"  number,  and  the  characteristics 
of  those  "types"  should  be  prescribed  on  these  DT-cards.  Up  to  10  DT 
cards  are  permitted;  code  1  type  per  DT  card. 


Field 

Variable 

Value 

Description 

Co  l 

1 

I  CG 

D 

Card 

group  D 

=  deposits 

Co  1 

2 

I  DT 

T 

Data 

by 

type  T  = 
type 

characterist  ics 

of  deposits 

Co  1 

8 

[TYPE 

+ 

Type 

numbe  r s 

1  through  10  are 

permitted 

Start  with  1 


Layer  type  No.  1  must  be  freshly  deposited, 
unconsolidated  material.  Layers  with 
ITYPE  greater  than  MNCL  (SC  card)  do  not 
consolidate 


2  THKTYP 


3  TAUP 


4  PERU 


3  QS  l 


b  QSE 


+  Code  the  typical  layer  thickness  in  meters 

for  this  type  of  bed  material 

0  Default  value  is  0.03  m 

+  The  bed  shear  stress  at  which  cohesive 

particles  begin  to  erode,  newtons/m’ 

0  Program  defaults  to  0.06  newtons/m2 

+  Erosion  rate  constant  for  particle  erosion 

0  Default  value  is  0.002  kg/m^/sec 

+  The  bed  shear  stress  at  which  cohesive  2 

layers  begin  to  erode  in  mass,  newtons/m 

0  Program  defaults  to  0.06,  0.12,  0.41,  and 

3.4  for  layers  1-4,  respectively,  and  3.4 
for  layer  types  5-LNBL 

+  The  bed  shear  stress  at  which  cohesive 

layers  1  ^  e  a  r  old  begin  to  erode  in  mass, 
newtons/m^ 


Program  defaults  to  1.1  times  the  default 
values  of  QSl 


0 


04/85 


DT  CARD  (Continued) 


1 d  Va  r i a ble  Value 


Descriptip n 


RHO  I 


+  The  initial  dry  density  of  a  deposit  of 

this  type  of  cohesive  material  in  kg/m3 


RHOE 


CCC 


0  The  program  defaults  to  90,  108,  144,  and 

263  for  layers  1-4,  respectively,  and  402 
for  layer  types  5-LNBL 

f  The  consolidated  dry  density  of  deposits 

of  this  type  of  cohesive  material  at 
age  =  1  year 

0  The  program  defaults  to  l.l  times  the  de¬ 

fault  values  of  RHO  I 

+  The  consolidation  coefficient  relating  the 

change  from  RHOE  and  QSE  to  time  in  years 

0  Program  defaults  to  256  kg/m3 


Values  of  the  variables  in  Fields  5-9  vary  widely  among  sediment 
types.  Default  values  may  be  grossly  wrong  for  a  given  sediment. 
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ML 


04/85 


DC  CARD 


Layering  of  Cohesive 
or  Mixed  Sediments  in  the  Bed 


Required  for 
cohesive  bed  problems 
unless  tape  input 
provides  this 
i n  forma  t ion 


There  are  two  coding  options  as  described  in  the  introduction. 
Coding  Options  for  Nodal  Point  Data,  and  shown  below  for  "Column  3." 


Field 

Variable 

Value 

Description 

Co  1 

1 

ICG 

D 

Card  group  D  =  deposits  in  the  bed 

Col 

2 

IDT 

C 

Data  type  C  =  clay 

Col 

3 

Coding  options 

t 

=  constant  value,  use  at  all  nodes 

N 

N  =  values  for  nodes  (place  all  0  cards 
before  first  N  cards) 

Col 

5-6 

YEAR 

+ 

Code  the  last  two  digits  of  the  year  when 
bed  was  sampled 

Col 

00 

1 

MONTH 

+ 

Code  a  two-digit  number  for  month  (JAN  -  01 
to  DEC  -  12) 

2 

DAY 

HOUR 

MINUTE 

SECONDS 

+ 

Code  DAY,  HOUR,  MINUTE,  and  SECOND  the  bed 
sample  was  taken.  Start  in  Column  9  and 
use  2  columns  for  each.  A  blank  is  read  as 

zero.  (This  field  is  read  as  F8.0  and  par¬ 
titioned  into  columns  of  two  digits  each) 

3 

Node 

+ 

Code  the  node  number 

4 

LAYER 

+ 

Code  the  layer  number  for  this  data  type. 
Numbering  starts  with  one  for  the  lowest 
layer  and  increases  upward  (maximum  of 

LNBL,  dimensioned  to  10) 

5 

ITYPE 

+ 

Assign  one  of  the  clay  types  coded  previ¬ 
ously  on  DT  cards 

6 

THICKL 

+ 

Code  the  total  layer  thickness  in  meters 

0 

Program  assigns  thickness  on  the  DT  card 
for  this  type  of  deposit 

7 

AGE 

+ 

Code  the  age,  years,  of  the  deposit  at 

time  zero  TZ  card 


STUDH 
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04/85 


FT  CARD  Water  Temperature  Required 

When  coding  more  than  one  time  point,  enter  the  YEAR/MONTH/ DAY/ 
HOUR/MINUTE/SECOND  for  each  successive  time  using  the  format  for  the 
first  one.  If  two  or  more  options  are  used  for  coding  this  data  type, 
stack  the  cards  in  the  order  shown  for  Column  3  below. 


Field  Variable  Value  _ Description 


Col 

1 

ICC 

F 

Card  group  F  =  Flow 

Col 

2 

IDT 

T 

Data  type  T  =  Temperature 

Col 

3 

ISI  i 

Coding  options 

Blank  =  constant  value  for  all  nodes 

X 

X  =  constant  value  for  all  nodes  on 

this  cross  section 

c 

C  =  values  by  corner  nodes 

N 

N  =  values  by  node 

Col 

5-6 

YEAR 

+ 

Code  the  last  two  digits  of  the  year 

Col 

00 

MONTH 

+ 

Code  the  month  number  (01-12) 

2 

DAY 

+ 

Code  the  DAY,  HOUR,  MINUTE,  and  SECOND  for 

HOUR 

+ 

this  event.  Use  two  columns  each  (01-31) 

MINUTE 

+ 

(01-60),  etc. 

SECOND 

+ 

3 

LO  C  | 

+ 

Code  the  Locator  for  WTCj 

for  option  -  code  first  node 

for  X  option  -  code  cross-section  number 
for  C  option  -  code  corner  node 
for  N  option  -  code  node 

4 

WTC  i 

+ 

Code  water  temperature  in  degrees 

Centigrade 

5 

loc2 

+ 

Code  the  locator  for  WTC 2 

6 

wtc2 

+ 

Code  water  temperature  at  LOC2 

(7- 

10) 

etc. 

Use  all  10  fields.  .  .start  continuation 

cards  in  field  1  and  do  NOT  code  date/time. 
Leave  at  least  one  blank  LOC-field  at  the 
end  of  data  even  it  if  requires  an  addi- 
t  Iona  l  card  . 

G- 1 -43 


STUD  H 


04/ 


FD  CARD 


Fluid  Density 


Required 


When  coding  more  than  one  time  point,  enter  the  YEAR/MONTH/DAY/ 
HOUR/MINUTE/SECOND  for  each  successive  time  using  the  format  for  the 


f  i  r  s  t 
stack 

one .  If  two 

the  cards  in 

or  more  options  are  used  for  coding  this  data  type, 
the  order  shown  for  Col  3  below. 

Field 

Variable 

Value 

Description 

Co  l  l 

ICG 

F 

Card  group  F  =  Fluid 

Col  2 

IDT 

D 

Data  type  D  =  Density 

Col  3 

ISI  1 

Coding  options 

t> 

X  =  constant  value  for  all  nodes  on 
this  cross  section 

C 

C  =  values  by  corner  nodes 

N 

N  =  values  by  node 

Col  5- 

6  YEAR 

+ 

Code  the  last  two  digits  of  the  year 

Col  7- 

S  MONTH 

+ 

Code  the  month  number  (01-12) 

2 

DAY 

HOUR 

MINUTE 

SECOND 

+ 

+ 

+ 

+ 

Code  the  DAY,  HOUR,  MINUTE,  and  SECOND  for 
this  event.  Use  two  columns  each  (01-31) 
(01-60),  etc. 

3 

LOC  j 

+ 

Code  the  locator  for  RHOi 
for  $  option  -  LOC  =  1 

for  X  option  -  LOC  =  cross-section  number 

for  C  option  -  LOC  =  corner  node  number 

for  N  option  -  LOC  =  node  number 

4 

RHO  l 

+ 

Code  fluid  density  in  kg/m 

3 

1.0C2 

+ 

Code  the  locator  for  RHO2 

6 

RH  02 

+ 

Code  density  at  location  2 

(7-10) 

etc. 

+ 

Use  all  10  fields. ..start  continuation 

cards  in  Field  1  and  do  NOT  code  date/time 
Leave  at  least  one  blank  LOC-field  at  the 
end  of  data  even  if  it  requires  an  addi¬ 
tional  card 


S  f  U  D  H 


C- 1 -44 


HS  CARD 


Bed  Shear  Stress 


Required 


Field 

Variable 

Value 

Description 

Col  1 

ICC, 

H 

Card  Croup  H  =  Hydraulic  data 

Col  2 

IDT 

S 

Data  type  S  =  Shear  stress 

2 

MSC 

Code  the  option  number  for  shear  stress 
computations 

t 

Shear  stress  computation  using 

the  log-velocity  distribution  for  a  smooth 

wall 

2  Manning  equation  (must  enter  11-values  on 

HN-card  s  ) 

3  Wave  shear  stress  by  ACKRSHR 
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04/85 


HH  CARD  Water  Surface  Elevations  Required 

if  water  levels 
not  input  on  file 

When  coding  more  than  one  time  point,  enter  the  YEAR/MONTH/DAY/ 

HOU R/ M I NUTE/ SECOND  for  each  successive  time  using  the  format  for  the 
first  one.  If  two  or  more  options  are  used  for  coding  this  data  type, 
stack  the  cards  in  the  order  shown  for  Column  3  below. 


Field  Variable  Value  _ Description 


Col 

1 

ICG 

H 

Card  group  H  =  Hydraulics 

Col 

2 

IDT 

H 

Data  type  H  =  Water  surface 

Col 

3 

ISI, 

Cod  i  ng  options 

t 

Blank  =  constant  value  for  all  nodes 

X 

X  =  constant  value  for  all  nodes  on 
this  cross  section 

C 

C  =  values  by  corner  nodes 

N 

N  =  values  by  node 

Col 

5-6 

YEAR 

+ 

Code  the  last  two  digits  of  the  year 

Co  l 

7-8 

MONTH 

+ 

Code  the  month  number  (01-12) 

2 

DAY 

HOUR 

M I NUTE 
SECOND 

+ 

+ 

+ 

+ 

Code  the  DAY,  HOUR,  MINUTE,  and  SECOND  for 
this  event.  Use  two  columns  each  (01-31) 
(01-60),  etc. 

1 

LOC  j 

+ 

Code  the  locator  for  WSi 
for  i>  option  -  LOC  =  1 

for  X  option  -  LOC  =  cross-section  number 

for  C  option  -  LOC  =  corner  node  number 

for  N  option  -  LOC  =  node  number 

4 

WS[ 

+ 

Code  the  value  for  water  surface  in  meters 

5 

LOC  2 

+ 

Code  the  locator  for  WSj 

6 

W  S  2 

+ 

Code  water  surface  for  location  2 

(  7- 

10) 

etc. 

Use  all  10  fields.,  .start  continuation 

cards  in  Field  1  and  do  NOT  code  date/time. 
Leave  at  least  one  blank  I.OC-field  at  the 
end  of  data  even  if  it  requires  an  addi¬ 
tional  card 


C- 1 -47 


STD  Dll 


HU  CARD 


X-Velocity 


Requi red  If  not  on 
file  and  no  QX  ,  QZ 
cards  used 


When  coding  more  than  one  time  point,  enter  the  YEAR/MONTH/DAY/ 

H OU R/ M I  NUT E / SE CO N D  for  each  successive  time  using  the  format  for  the 
first  one.  If  two  or  more  options  are  used  for  coding  this  data  type, 
stack  the  cards  in  the  order  shown  for  Column  3  below. 


Field 


Variable 


Value 


Description 


Col 

1 

ICC 

H 

Card  group  H  =  Hydraulics 

Co  l 

2 

IDT 

U 

Data  type  U  =  velocity  in  X-direction 

Co  1 

3 

ISI, 

Coding  options 

t 

Blank  =  constant  value  for  all  nodes 

Col  S-6  YEAR 
Col  7-8  MONTH 

2  DAY 
HOUR 

M I NUTE 
SECOND 

3  LOC. 


X  =  constant  value  for  all  nodes  on 
this  cross  section 

C  ■  values  by  corner  nodes 

N  =  values  by  node 

*-  Code  the  last  two  digits  of  the  year 

Code  the  month  number  (01-12) 

Code  the  DAY,  HOUR,  MINUTE,  and  SECOND  for 
this  event.  Use  two  columns  each  (01-31) 
(01-60),  etc. 

Code  the  locator  for  XV Eh (1,1) 


for 

t 

option  - 

LOC  = 

1 

for 

X 

option  - 

LOC  = 

cross- sect  i 

on  number 

tor 

c 

option  - 

LOC  = 

corner  node 

number 

for 

N 

option  - 

LOC  = 

node  number 

4 

XVEL(  1,1) 

+ 

Code 

X-velocity  in 

m/sec,  +  X- 

When 

X-velocity  is 

in  negative 

5 

LOC  2 

+ 

Code 

the  locator  for  X  V  E  L ( 2 ,  1  ) 

6 

XVEL( 2,1) 

+ 

Code 

X-velocity  at 

location  2 

- 

When 

LOC  2  velocity 

is  in  negat 

STUDH 
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HU  CARD 


X-Veloctty  (Continued) 


Field  Variable  Value 


Descript  ion 


(7-10)  etc.  Use  all  10  f i e 1 d s  .  .  .  s t a r t  continuation 

cards  in  Field  1  and  do  NOT  code  date/time 
Leave  at  least  one  blank  LOC-field  at  the 
end  of  data  even  if  it  requires  an  addi¬ 
tional  card 
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STUD  H 


04/85 

HV  CARO  Y-Velocity  Required  if  not  on  file 

and  no  QX,  QY  cards  used 

When  coding  more  chan  one  time  point,  enter  the  YEAR/MONTH/DAY/ 
HOU R/ M I NUTE / S ECON D  for  each  successive  time  using  the  format  for  the 
tirst  one.  If  two  or  more  options  are  used  for  coding  this  data  type, 
stack  the  cards  in  the  order  shown  for  Column  3  below. 


Field 

Variable 

Value 

Description 

Co  1 

1 

ICG 

H 

Card  group  H  *  Hydraulics 

Co  1 

2 

IDT 

W 

Data  type  V  ■  Y-velocity 

Co  1 

3 

LSI, 

Coding  options 

Blank  *=  constant  value  for  all  nodes 

X 

X  =  constant  value  for  all  nodes  on 

cross  section 

c 

C  =  values  by  corner  nodes 

N 

N  =  values  by  node 

Co  1 

5-6 

YEAR 

+ 

Code  the  last  two  digits  of  the  year 

Co  1 

7-8 

MONTH 

+ 

Code  the  month  number  (01-12) 

2 

DAY 

+ 

Code  the  DAY,  HOUR,  MINUTE,  and  SECOND  for 

HOUR 

+ 

this  event.  Use  two  columns  each  (01-31) 

MINUTE 

+ 

(01-60),  etc. 

SECOND 

+ 

3 

LOG  j 

+ 

Code  the  locator  for  XVEL(1,2) 

for  b  option  -  LOC  =  1 

for  X  option  -  LOC  =  cross-section  number 

for  C  option  -  LOC  =  corner  node  number 

for  N  option  -  LOC  =  node  number 

4 

X  V  K  L (  1,2) 

+ 

Code  Y-velocity  in  m/sec,  +  Y-direction 

- 

When  Y-velocity  component  points  in 

the  negative  Y-direction 

5 

LOG  2 

+ 

Code  the  locator  for  XVEL(2,2) 

6 

XVE  l,(  2 , 2  ) 

- 

When  LOC2  velocity  is  in  negative  Y 

direction 


s  run H 


O- | -50 


HV  CARD 


Y-Velocity  (Continued) 


Field  Variable 


Value 


Descript  ion 


(7-10)  etc. 


Use  all  10  f  i  e Id s  .  .  .  s t a r t  continuation 

cards  in  Field  1  and  do  NOT  code  date/time 
Leave  at  least  one  blank  LOC-field  at  the 
end  of  data  even  if  it  requires  an  addi¬ 
tional  card 
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04/85 


QX  CARD  X- Direction  Discharge  Required  it'  velocities 

are  not  on  file  and  no 
HU,  HV  cards  used 

When  coding  more  than  one  time  point,  enter  the  YKAK/ MONTH/ DAY/ 

H OUR/MIX UTK/ SECOND  for  each  successive  time  using  the  format  for  the 
first  one.  If  two  or  more  options  are  used  for  coding  this  data  type, 
stack,  the  cards  in  the  order  shown  for  Column  3  below. 


Field 


Variable 


Value 


Description 


Co  1  l 
Co  1  2 
Co  1  3 


ICC 
l  DT 
IS  [ 


Col  5-6 

YF.AR 

Col  7-8 

MONTH 

DAY 

HOUR 

MI  NUT K 
SF.COND 

3 

LOC  | 

U 

X  V  K  L  (  1 

5 

LOC  2 

6 

X  V  K  L  (  2 

Q 

x 

* 

X 

c 

N 


Card  group  Q  =  Discharge 
Data  type  X  =  X-velocity 

Coding  options 

Blank  =  constant  value  for  all  nodes 

X  =  constant  value  for  all  nodes  on 

cross  section 

C  =  values  by  corner  nodes 

N  =  values  by  node 

Code  the  last  two  digits  ol  the  year 

Code  the  month  number  (01-12) 

Code  the  DAY,  HOUR,  MINUTK,  and  SKCOND  for 
this  event.  Use  two  columns  each  (01-31) 
(01-60),  etc. 


+ 

Code  the  locator 

f  o  r 

X  V  K  L  (  1  ,  1  ) 

for  b  option  - 

LOC 

=  1 

for  X  option  - 

LOC 

=  cross-sect  ion  nun her 

for  C  option  - 

LOC 

=  corner  node  nun  hi*  r 

for  N  option  - 

LOC 

-  n  od c  number 

+ 

Code  X-discharge 

i  n  m 

1/see ,  +  X-dircction 

- 

When  X-discharge 

i  s  i 

n  n  e  a  t  i  v  < » 

X-direction 

+■ 

Code  the  locator 

for 

X  V  K  L  (  2  ,  2  ) 

- 

When  LOC 2  discha 

r  g  e  i 

s  in  negative 

X-direction 

<;-  I  -  V> 


QX  CARD 


X-Di  red  ion  Discharge  (Continued) 


Field  Variable  Value 
(7-10)  etc. 


_ _  Descri  ption _ 

Use  all  10  fields. ..start  continuation 

cards  in  Field  1  and  do  NOT  code  date/ti 
Leave  at  least  one  blank  LOC-field  at  tl 
end  of  data  even  if  it  requires  an  addi¬ 
tional  card 


0-1  -  S') 


s  t  i*  mi 


QY  CARD  Y-Discharge  Required  if  veloci¬ 

ties  not  on  file 
and  no  HU ,  HV 
cards  used 

When  coding  more  than  one  time  point,  enter  the  YEAR/ MONTH/ DAY / 
HOU R/ MI  NUT E / S ECOND  for  each  successive  time  using  the  format  for  the 
first  one.  If  two  or  more  options  are  used  for  coding  this  data  type, 
stack  the  cards  in  the  order  shown  for  Column  3  below. 


Field  Variable  Value 


Description 


Col 

1 

I  CG 

Q 

Co  1 

2 

IDT 

V 

Col 

3 

ISI  , 

* 

X 


C 

N 


Col 

5-6 

YEAR 

+ 

Col 

7-8 

MONTH 

+ 

2 

DAY 

+ 

HOUR 

+ 

MINUTE 

+ 

SECOND 

+ 

3 

LOC 

+ 

k 

X  V  E  L ( 1,2) 

+ 

5 

L0C2 

+ 

6 

XVEL( 2,2) 

+ 

Card  group  Q  =  discharge 
Data  type  Y  =  in  Y-direction 


Coding 

opt  ions 

Blank  = 

constant 

value  for 

all 

nodes 

X  = 

constant 

value  for 

all 

nodes  on 

this  cross  section 

C  = 

values  by 

corner  nodes 

N  = 

values  by 

node 

Code  the  last  two  digits  of  the  year 

Code  the  month  number  (01-12) 

Code  the  DAY,  HOUR,  MINUTE,  and  SECOND  for 
this  event.  Use  two  columns  each  (01-31 
(01-60),  etc. 


Code  the  locator 
for  D  option  - 
for  X  option  - 
for  C  option  - 
for  N  option  - 

Code  Y-discharge 

When  Y-discharge 

negative  Y-direction 

Code  the  locator  for  XVEL(2,2) 

Code  discharge  at  location  2 

When  LOC2  discharge  is  in  negative 
Y-direction 


X  V  E  L (  1,2) 

LOC  =  1 

U)C  =  cross-section  number 
LOC  *  corner  node  number 
LOC  =  node  number 

in  m^/sec,  +  Y-direction 

component  points  in  the 


* 


STUDH 


0- 1-56 


QY  CARD 


Y-Discharge  (Continued) 


Field  Variable 


(7-10)  etc. 


Value  Description 


When  all  10  f  ields ..  .start  continuation 

cards  in  Field  1  and  do  NOT  code  date/time 
Leave  at  least  one  blank  LOC-field  at  the 
end  of  data  even  if  it  requires  an  addi¬ 
tional  card 


G-l-55 


STUDH 
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EX  CARD 


Effective  Diffusion,  X-Direction 


Required 


When  coding  more  than  one  time  point,  enter  the  YE AR/ MONTH/ DAY/ 
HOUR/MI  MUTE/ SECOND  for  each  successive  time  using  the  format  for  the 
first  one.  If  two  or  more  options  are  used  for  coding  this  data  type, 
stack  the  cards  in  the  order  shown  for  Column  3  below. 


Variable 


Value 


Description 


Col  1 


Card  group  =  effective  diffusion 


Co  1  2 


Data  type  =  X-direction 


Col  3 


Coding  options 


Blank  =  constant  value  for  all  nodes 

X  =  constant  value  for  all  nodes  on 

this  cross  section 

C  =  values  by  corner  nodes 

N  =  values  by  node 


Col  5-6  YEAR 


Col  7-8  MONTH 


Code  the  last  two  digits  of  the  year 
Code  the  month  number  (01-12) 


DAY 

HOUR 

MINUTE 

SECOND 


Code  the  DAY,  HOUR,  MINUTE,  and  SECOND  for 
this  event.  Use  two  columns  each  (01-31) 
( 0 1 -60  )  ,  etc. 


Code  the  locator  for  DIE (1,2) 
for  option  -  LOC  «  1 

for  X  option  -  LOC  »  cross-section  numher 

for  C  option  -  LOC  =  corner  node  number 

for  N  option  -  LOC  *  node  number 


D I  F  (  1  ,  2  ) 


Code  the  X-dif fusion  coetficient  in 
m2  / s  e  c 


D I  F  (  2  ,  2  ) 


Code  the  locator  for  DIF (2, 2) 

Code  the  X-diffuston  coefficient  for  LOC 
insqmpersec  ‘ 


S  T  U  D  H 


C-  1  -56 


V  -V  ,  ■  ,  •  . 


K  X  CARD 


Effective  Diffusion,  X-Direction  (Continued) 


Field  Variable  Value  _ Description  _ 

(7-10)  etc.  Use  all  10  f i e 1 d s . . . s t a r t  continuation 

cards  in  Field  1  and  do  NOT  code  date/time 
Leave  at  least  one  blank  LOC-field  at  the 
end  of  data  even  if  it  requires  an  addi¬ 
tional  card 


r 


K* 


-  .  * 

W. 

or? 


V.v 

b m  * 

K-r  '  •**.• 


G- 1 -57 


STUDH 


EY  CARD 


Effective  Diffusion,  Y-Direction 


Required 


When  coding  more  than  one  time  point,  enter  the  YE AR/ MONTH/ DAY/ 
HOUR/MINUTE/SECOND  for  each  successive  time  using  the  format  for  the 
first  one.  If  two  or  more  options  are  used  for  coding  this  data  type 
stack  the  cards  in  the  order  shown  for  Column  3  below. 


Field 


Co  1  l 
Co  1  2 
Co  1  3 


Va  r 1  a  b  1  e 
ICG 


Col  5-6  YEAR 

Col  7-8  MONTH 

2  DAY 

HOUR 
MINUTE 
SECOND 


Value  Description 


E  Card  group  =  effective  diffusion 

Y  Data  type  =  Y-  direction 

Coding  options 

f>  Blank  =  constant  value  for  all  nodes 

X  X  =  constant  value  for  all  nodes  on 

this  cross  section 

C  C  =  values  by  corner  nodes 

N  N  *  values  by  node 

+  Code  the  last  two  digits  of  the  year 

+  Code  the  month  number  (01-12) 

+  Code  the  DAY,  HOUR,  MINUTE,  and  SECOND  for 

+  this  event.  Use  two  columns  each  (01-31) 

+  (01-60),  etc. 

+ 

+  Code  the  locator  for  DIF (1,2) 


for 

option  - 

L0C  = 

1 

for 

X 

option  - 

L0C  = 

cross-section  number 

for 

c 

option  - 

LOC  = 

corner  node  number 

for 

N 

option  - 

L0C  = 

node  n  umbe r 

D  I  F  (  1  ,  2  ) 

loc2 

D  l  F  (  2  ,  2  ) 


(7-10)  etc. 


Code  the  Y-diffusion  coefficient 
in  m^/sec 

Code  the  locator  for  DIF (2, 2) 

Code  the  Y-diffusion  coefficient  for  LOC2 

Use  all  10  f ields  ..  .start  continuation 

cards  in  field  1  and  do  NOT  code  date/time 
Leave  at  least  one  blank  LOC-field  at  the 
end  of  data  even  if  it  requires  an  addi- 
t  Ional  card 


STUD  H 


G- I -58 
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I C  CARD  Initial  Concentration  Required 

When  coding  more  than  one  time  point,  enter  the  YEAR/ MONTH / DAY / 
I10U R/ M I  NUT E / SECON D  for  each  successive  time  using  the  format  for  the 
first  one.  If  two  or  more  options  are  used  for  coding  this  data  type, 
stack  the  cards  in  the  order  shown  for  Column  3  below. 


Field 

Variable 

Value 

Description 

Col 

1 

ICG 

I 

Card  group  I  =  initial  value  (state  value) 

Col 

2 

IDT 

c 

Data  type  C  =  concentration 

Co  L 

3 

ISli 

Coding  options 

t 

Blank  =  constant  value  for  all  nodes 

X 

X  =  constant  value  for  all  nodes  on 

this  cross  section 

c 

C  =  values  by  corner  nodes 

N 

N  =  values  by  node 

Co  l 

5-6 

YEAR 

+ 

Code  the  last  two  digits  of  the  year 

Co  1 

X 

1 

MONTH 

+ 

Code  the  month  number  (01-12) 

2 

DAY 

+ 

Code  the  DAY,  HOUR,  MINUTE,  and  SECOND  for 

HOUR 

+ 

this  event.  Use  two  columns  each  (01-311 

MINUTE 

+ 

(01-60),  etc. 

SECOND 

+ 

3 

LOC  j 

+ 

Code  the  locator  for  CONCi 

for  (S  option  -  LOC  =  1 

for  X  option  -  LOC  =  cross-section  number 

for  C  option  -  LOC  =  corner  node  number 

for  N  option  -  LOC  =  node  number 


4 

CON C , 

+ 

Code 

O 

concentration  in  kg/mJ 

5 

loc2 

+ 

Code 

the  locator  for  CONC2 

6 

CONC2 

+ 

Code 

concentration  at  L0C2 

-10) 

etc. 

Use  all  10  fields. ..start  continuation 

cards  in  field  1  and  do  NOT  code  date/time 
Leave  at  least  one  blank  l.OC-field  at  the 
end  of  data  even  if  it  requires  an  addi¬ 
tional  card 

C- I -59 


STUDH 


SR  CARD 


Effective  Crain  Size  for  Roughness 


Optional 


NOTE:  If  an  SR  is  not  used,  the  EFDR  array  defaults  to  S  D ( 1 ) 

as  determined  from  the  SA  card  data. 

When  coding  more  than  one  time  point,  enter  the  YE A R/ MONTH / DA Y/ 
HOU R/ M I NUT E / SE CON D  for  each  successive  time  using  the  format  for  the 
first  one.  If  two  or  more  options  are  used  for  coding  this  data  type, 
stack  the  cards  in  the  order  shown  for  Column  3  below. 


Field  Variable  Value 


Description 


Co  1 

1 

ICC 

Co  l 

2 

I  DT 

Co  1 

3 

I  S  I  1 

Col  5-6 

YEAR 

Col  7-8 

MONTH 

2 

DAY 

HOUR 

M I NUTE 
SECOND 

3 

LOC  , 

A  E  F  D  R  i 

3  LOC2 

b  E  K  D  R  2 

(7-10)  etc. 


S  Card  group  S  =  sediment 

R  Data  type  R  =  roughness  size 

Coding  options 

$  Blank  =  constant  value  for  all  nodes 

X  X  =  constant  value  for  all  nodes  on 

this  cross  section 

C  C  =  values  by  corner  nodes 

N  N=  values  by  node 

+  Code  the  last  two  digits  of  the  year 

+  Code  the  month  number  (01-12) 

+  Code  the  DAY,  HOUR,  MINUTE,  and  SECOND  for 

+  this  event.  Use  two  columns  each  (01-31) 

+  (O' -60),  etc. 


Code 

the 

■  locator 

for 

EFDRi 

for 

6 

option  - 

LOC 

=  1 

for 

X 

option  - 

LOC 

=  cross-section  number 

for 

c 

option  - 

LOC 

=  corner  node  number 

for 

N 

option  - 

LOC 

=  node  number 

+  Code  De r 

+  Code  the  locator  for  EFDR2 

+  Code  Der  at  location  2 

Use  all  10  fields. ..start  continuation 

cards  in  Field  1  and  do  NOT  code  date/time 
heave  at  least  one  hlank  LOC-field  at  the 
end  of  data  even  if  it  requires  an 
additional  card 


04/85 


ST  CARD  Effective  Grain  Size  for  Transport  Optional 

NOTE:  If  an  ST  card  is  not  used,  the  EFDT  array  defaults  to  the 

EFDR  array  specified  by  the  SR  card. 

When  coding  more  than  one  time  point,  enter  the  YE AR / MONTH / DAY/ 
HOUR/MINUTE/SECOND  for  each  successive  time  using  the  format  for  the 
first  one.  If  two  or  more  options  are  used  for  coding  this  data  type, 
stack  the  cards  in  the  order  shown  for  Column  3  below. 


Field  Variable  Value 


Description 


Col  l  ICG 

Col  2  IDT 

Col  3  I  S  1 1 


Col  5-6  YEAR 

Col  7-8  MONTH 

2  DAY 

HOUR 
MINUTE 
SECOND 


S  Card  group  S  =  sediment 

T  Data  type  T  =  transport  size 

Coding  options 

Blank  -  constant  value  for  all  nodes 

X  X  =  constant  value  for  all  nodes  on 

this  cross  section 

C  C  =  values  by  corner  nodes 

N  N  =  values  by  node 

+  Code  the  last  two  digits  of  the  year 

+  Code  the  month  number  (01-12) 

+  Code  the  DAY,  HOUR,  MINUTE,  and  SECOND  for 

+  this  event.  Use  two  columns  each  (01-31) 

+  (01-60),  etc. 

+ 


3  LOCj 

4  EFDT] 

5  LOC2 

6  EFDT2 

(7-10)  etc. 


Code 

the  locator 

for 

EFDT, 

for 

option  - 

L0C 

=  1  1 

tor 

X  option  - 

LOC 

=  cross-section  number 

for 

C  option  - 

LOC 

=  corner  node  number 

for 

N  option  - 

LOC 

=  node  number 

Code 

grain  size 

Code 

the  locator 

For 

EFDT  2 

+  Code  grain  size  at  location  2 

Use  all  10  fields.  ..start  continuation 

cards  in  Field  1  and  do  NOT  code  date/time. 
Leave  at  least  one  blank  LOC-field  at  the 
end  of  data  even  if  it  requires  an  addi- 
t  iona  1  card 


G- 1 -6 1 


STUDH 
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WCCARD  Settling  Velocity  Required 

When  coding  more  than  one  time  point,  enter  the  YE AR/ MONTH/ DAY/ 
HOUR  / MINU'f E/SECOND  for  each  successive  time  using  the  format  for  the 
first  one.  If  two  or  more  options  are  used  for  coding  this  data  type, 
stack  the  cards  in  the  order  shown  for  Column  3  below. 


Field 

Variable 

Value 

Description 

Co  1 

1 

ICC 

w 

Card  group  W  =  settling  velocity 

Co  1 

2 

I  DT 

c 

Data  type  C  =  clay,  silt,  and  sand 

Co  l 

3 

ISI, 

Coding  options 

Blank  =  constant  value  for  all  nodes 

X 

X  =  constant  value  for  all  nodes  on 
this  cross  section 

c 

C  =  values  by  corner  nodes 

N 

N  =  values  by  node 

Co  1 

5-6 

YEAR 

+ 

Code  the  last  two  digits  of  the  year 

Co  l 

7-8 

MONTH 

+ 

Code  the  month  number  (01-12) 

2 

DAY 

HOUR 

MINUTE 

SECOND 

+ 

+ 

+ 

+ 

Code  the  DAY,  HOUR,  MINUTE,  and  SECOND  for 
this  event.  Use  two  columns  each  (01-31) 
(01-60),  etc. 

3 

LOC 

+ 

Code  the  locator  for  VS. 
for  b  option  -  LOC  =  I 

for  X  option  -  LOC  =  cross-section  number 

for  C  option  -  LOC  =  corner  node  number 

for  N  option  -  LOC  =  node  number 

4 

VSl 

+ 

Code  settling  velocity  in  m/sec 

5 

LOC2 

+ 

Code  the  locator  for  VS2 

6 

vs2 

+ 

Code  settling  velocity  for  particles  at 
location  2 

(7-10) 

etc. 

Use  all  10  fields. ..start  continuation 

cards  in  Field  1  and  do  NOT  code  date/time 
Leave  at  least  one  blank  LOC-field  at  the 
end  of  data  even  if  it  requires  an  addi¬ 
tional  card 

S  fUDH 


G-  1  -62 
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BC  CARD  Boundary  Concentrations  Required 

When  coding  more  than  one  time  point,  enter  the  Y EAR/ MONTH / DAY / 

H  OUR/MINUTE/SECOND  for  each  successive  time  using  the  format  for  the 
first  one.  If  two  or  more  options  are  used  for  coding  this  data  type, 
stack  the  cards  in  the  order  shown  for  Column  3  below. 


Field  Variable  Value  Description _ 

Col  1  ICC  B  Card  group  B  =  boundary  nodes 

Col  2  IDT  C  Data  type  C  =  concentrations 

Col  3  I S I !  Coding  options 

$  Blank  =  constant  value  for  all  nodes 

X  X  =  constant  value  for  all  nodes  on 

this  cross  section 

C  C  =  values  by  corner  nodes 

N  N=  values  by  node 

Col  5-6  YEAR  +  Code  the  last  two  digits  of  the  year 

Col  7-8  MONTH  +  Code  the  month  number  (01-12) 

2  DAY  +  Code  the  DAY,  HOUR,  MINUTE,  and  SECOND  for 

HOUR  +  this  event.  Use  two  columns  each  (01  —  31  ) 

MINUTE  +  (01 -60  )  ,  etc. 

SECOND  + 

LOCj  +  CodethelocatorforSPECj 

for  option  -  LOC  =  1 

for  X  option  -  LOC  =  cross-section  number 
for  C  option  -  LOC  =  corner  node  number 

for  N  option  -  LOC  =  node  number 


u 

S  P  E  C  i 

+ 

Code  concentration 

kg/m3 

at  boundary  node(s)  in 

5 

L0C2 

+ 

Code  the  locator  for  S  P  E  C  2 

6 

S  P  E  C  2 

+ 

Code  concentration 

at  location  2 

(7-10) 

etc. 

Use  all  10  fields, 
cards  in  Field  1 

..start  continuation 
and  d o  NOT  code  date  / 1  ini' 

Leave  at  least  one  blank  LOC-field  at  the 
end  of  data  even  if  it  requires  an  addi¬ 
tional  card 


G- 1 -63 


STUDH 


0 


SSEND 

End  of  Job 

V  i  e  1  d 

Variable 

Value 

Description 

Co  1  t 

ICC 

S 

Card  type  S 

=  Command 

Co  1  2 

l  DT 

s 

Data  type  $ 

=  Command 

Col  3-5 

IS  l 

END 

The  program 

tests  for  $$  and  the  word  END 

is  only  for  Che  user 


S  T  U  D  H 


<;- 1  -  Hu 


n  u  / «  5 


IT K RATION  CONTROL  FOR  INPUT/OUTPUT 
RKQUIRKI)  CARDS 


The  following  cards  follow  the  $$KND  if  no  $T  cards  are  used.  They 
must  be  omitted  if  $T  cards  follow  the  T3  card. 

Card  Purpose 


I  Pi' (2,1)  Print  out  at  selected  time -steps 

IVCOD(l)  Read  in  velocity  files  at  selected  time-steps 

ID1K(I)  Read  in  diffusion  coefficient  files  at  selected  time -steps 

IDKPC(I)  Read  in  depths  at  selected  time-steps 

ISVS(I)  Read  in  new  fall  velocities  at  selected  time -steps 

Note:  All  these  cards  are  read  as  8011.  Consequently,  to  print  re¬ 

sults,  code  1  (concentrations  only),  2  (bed  e  l  e v a t  i  on / vo 1 urne  changes 
only),  or  3  (both  concentration  and  bed  surface  information)  in  the  col¬ 
umn  number  corresponding  to  the  time-step  when  printout  is  desired. 

To  read  a  new  velocity  field  or  diffusion  coefficient  set  or  depth  tile 
or  fall  velocity  of  grains  file,  code  1  in  the  card  column  corresponding 

to  the  time-step  when  data  should  be  read. 

For  example,  to  print  results  at  the  time-step  2  (i.e.,  the  end  of  the 
first  computation  time-internal  ,  DT)  code  3  in  column  2  of  the  IFF  (2,i) 
card. 


G- 1  -  h  3 
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APPENDIX  I:  GRAPHICS  DISPLAYS 


PART  I:  INTRODUCTION 


1.  Output  from  the  TABS-2  programs  can  be  displayed  in 
graphical  form  using  Te k t r on i x -c o ra pa t i bl e  and  Ca 1 co m p-c om pa t i b  1  e 
devices  and  line  printers.  Items  that  can  be  plotted  include: 

The  finite  element  mesh, 
b.  Velocity  vectors  from  RMA-2V. 

£.  Sediment  mass  transport  vectors  from  STUDH. 
d.  Time  history  plots  of  model  output. 
e_.  Contour  maps  of: 

(1)  Bed  elevations. 

(2)  Water  depths . 

(3)  Water  surface  elevations. 

(4)  Velocities. 

(5)  Bed  changes  (crosion/deposition) . 

(6)  Sediment  concentrations. 

(7)  Constituent  conce n t a t i ons  . 

(8)  Particle  paths. 

£.  Factor  of  sediment  concentrations  and  bed  changes. 

Graphical  output  is  also  produced  by  output  analysis  programs, 
which  are  described  in  Appendix  J.  Table  II  shows  the  plots 
available,  the  plotting  program  which  creates  the  plot  file,  and 
the  program  creating  the  data  file  that  serves  as  input  to  the 
plotting  program.  For  instructions  on  the  individual  programs, 
see  the  addenda  to  this  appendix  or  the  program  index  in  the  TABS 
manual  main  volume. 

2.  The  plot  files  are  created  by  GCS  and/or  METAPLOT  and, 
when  using  PROCLV,  are  saved  as  permanent  files.  They  should  be 
directed  to  the  desired  plotting  device  by  using  the  DIRECT 
program,  also  in  PROCLV.  Instructions  for  obtaining  plots  are 
contained  in  this  appendix. 


I  l 


GRAPHICS 


[•] 


Table  11 

Summary  of  Plots 


Plot 

P 1 o  t  t i ng 
Program 

Data  Sources 
From  Programs 

Mesh  by  region  and  total 

mesh 

QMESH 

QMESH 

Finite  element  mesh 

GFGEN 

GFGEN 

Finite  element  mesh  with 
and  dry  areas  defined 

we  t 

WDCPLT 

GFGEN , 

RMA-2V 

Velocity  vector  map 

V  P  LOT 

GFGEN  , 

RMA-2V 

Sediment  mass  vector  map 

ACE 

ENGMET , 

STUDH 

Contour  bed  elevations 

CONTOUR 

GFGEN 

Contour  depths 

CONTOUR 

GFGEN, 

RMA-2V 

Contour  wa t e r - s u r f a c e 

e levat ions 

CONTOUR 

GFGEN , 

RMA-2V 

Contour  velocities  (mag¬ 
nitude) 

CONTOUR 

GFGEN , 

RMA-2V 

Contour  ELF.VGRD 
or  TRANSA  data 

CONTOUR 

F.LF.VGRD 

Contour  depth 
change  s 

CONTOUR 

ENGMET , 

STUDH 

Contour  concentrations 

CONTOUR 

ENGMET , 

STUDH 

Contour  first 
constituent  on 

RMA-4  file 

CONTOUR 

GFGEN , 

RMA-4 

Path  of  drogue  transported 
by  flow  field 

DROGUEPLT 

RMA-2V 

Time  history  of  water 
level  and/or  velocity 

POSTHYD* 

RMA-2V 

Factor  map  of  concentrations 
and/or  depth  changes 

SEDGRAPH 

RMA-2V 

Time  history  of  concentrations 

POSTSED* 

STUDil 

and/or  depth  changes 
*  S  e  e  Appendix  .1 


I  2 


OKAPI!  1  CS 
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PART  II.  METAPLOT  SYSTEM 


Introduction 


3.  METAPLOT  is  a  device  independent  plotting  software  pack¬ 
age  supported  in  the  TABS-2  system.  The  purpose  is  to  display 
plots  on  graphics  terminals  or  direct  them  to  a  hard  copy  device. 
The  programs  were  obtained  from  Air  Force  Weapons  Laboratory, 
Kirtland  Air  Force  Base,  New  Mexico.  They  have  been  modified  by 
Messrs.  S.  A.  Adaraec  and  D.  P.  Bach,  Estuaries  Division,  WES,  to 
operate  on  BCS  and  CYBERNET.  The  plots  themselves  are  created  by 
separate  programs  that  are  described  in  Part  III. 


Program  Design 


Hardware  and  capability 

4.  METAPLOT  supports  a  variety  of  plotting  devices.  The 
present  implementation  permits  use  of  Tek t r on ix-t y pe  graphics 
terminals.  Digital  Equipment  Corporation  VT-125  terminals,  and 
CALCOMP  devices.  The  plot  file  can  have  any  number  of  plots,  and 
they  can  be  viewed  in  any  sequence.  Both  line  segment  and 
character  strings  are  plotted.  Images  can  be  plotted  at  their 
generated  area  and  scale  or  regions  can  be  established  and  the 
images  can  be  magnified  up  to  200  times  their  original  scale. 

Software  components 

5.  The  MF.TAPLOT  system  consists  of  a  library  of  plotting 
routines  that  are  used  by  the  TABS-2  graphics  programs  to  create 
device  independent  plot  files  (META  files)  and  a  conversion 
program,  DIRECT.  Direct  converts  META  files  commands  into  com¬ 
mands  appropriate  to  the  desired  plotting  device.  In  interactive 
mode,  DIRECT  also  performs  windowing  and  other  image  manipula¬ 
tion.  A  version  of  the  Graphics  Compatibility  System  (GCS)  has 
been  developed  that  writes  META  files  for  use  by  program  DIRECT. 

Problem  size 


6.  This  program  handles  data  as  an  external  file  and  there¬ 
fore  does  not  require  redimensioning  to  be  compatible  with  code 
changes  in  other  programs  in  the  TABS-2  system. 
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Program  Use 


7.  There  are  three  steps  in  using  METAPLOT. 

o  Generate  and  save  the  plot  file, 
o  Direct  the  plot  file  to  a  graphics  device, 
o  Create  the  plots. 

8.  Those  programs  that  generate  plotter  output  are  shown  in 
Table  11.  These  are  executed  using  PROCLV.  The  plot  file,  like 
other  input/output  files,  is  assigned  a  permanent  file  name  by 
the  user  at  execution  time  and  is  automatically  saved  by  PROCLV. 

9.  The  DIRECT  program  is  initiated  by  the  command  sequence 

"BEGIN,  META,  PROCLV,  plot  file  name,  device" 

where  "plot  file  name"  is  the  permanent  file  name  of  the  plot 
file  and  “device"  is  the  device  on  which  the  plot  is  to  be  pro¬ 
duced.  Device  choices  are  “TEKTRNX”  (for  Tektronix-type 
terminals)  which  is  the  default,  "PRINTER,"  which  assumes  a  132- 
column  line  printer,  or  "VT125."  The  plot  file  is  directed  to 
the  terminal  which  responds  by  clearing  the  screen,  beeping  and 
printing  the  word  "READY."  For  CALCOMP  devices,  replace  "META" 
with  "METAB." 

10.  If  "READY"  does  not  appear,  the  terminal  is  not  set  at 
1200  band,  the  default  transmission  in  DIRECT.  Change  DIRECT  to 
the  terminal  baud  rate  using  the  BAUD  command  (see  DIRECT  COM¬ 
MANDS).  The  system  will  then  be  ready  to  accept  DIRECT  commands 
and  generate  the  requested  plot  images. 

11.  Use  the  plot  command  to  generate  the  first  image  as 
f  o l lows  : 


PLOT  n 


where  n  is  the  sequence  number  of  the  plot  (nth  plot  in  the 
file). 

12.  After  the  plot  finishes,  the  terminal  will  beep  and 
halt.  Control  is  returned  to  the  user  who  can  then  obtain  a  hard 
copy  of  the  plot,  magnify  (i.e.,  change  scale)  the  plot, 
establish  a  region  within  the  plotted  Image,  or  exercise  any  of 
the  other  DIRECT  commands. 
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13.  When  magnifying  or  establishing  a  region,  two  commands 
must  be  issued.  The  first  is: 

MAGNIFY  S 

or  REGION  S  T  U  V 

which  sets  up  the  plot  space.  The  subscript  variables  S,  T,  U, 
and  V  are  described  in  the  section  on  commands.  The  second 
command  required  to  plot  a  region  is: 


PLOT  nR 

where  "n"  is  defined  as  above  and  "R"  is  a  suffix  character 
activating  the  region  or  magnify  command. 

14.  If  the  R  is  left  off,  the  plot  will  be  at  the  same 
size  and  scale  as  the  original.  Once  a  region  or  magnification 
is  established,  it  can  be  used  with  any  plot  number,  n,  by  simply 
including  R  with  that  sequence  number  in  the  plot  command. 

Input 


15.  The  plot  file  and  DIRECT  commands,  which  are  Issued 
Interactively,  are  the  only  input  data  required. 

Out  put 

16.  The  plot  image  is  drawn  on  the  screen  or  hardcopy 
device.  No  other  output  is  created. 


Examp  1  e 


17.  F. a c h  of  the  Items  listed  in  Table  II  requires  the 
DIRECT  programs  to  create  the  images.  The  procedure  is  illus¬ 
trated  and  described  in  the  examples  which  follow  this  general 
description  of  DIRECT. 


DIRECT  Commands 


18.  DIRECT  commands  are  I  to  40  characters  in  length  and 
are  reasonably  free  field,  allowing  abbreviations  and  arbitrary 
delimiters  between  fields.  Commands  may  include  integer  or  real 
numeric  values.  The  form  of  these  fields  is  described  below. 

19.  An  Integer  value  begins  with  the  first  numeric  charac¬ 
ter  (  1 .  e . ,  d(git)  and  continues  up  to  but  not  including  the  first 
non-numeric  character.  The  numeric  value  is  the  value  associated 
with  the  string  of  digits. 

/*v 
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20.  A  real  value  begins  with  the  first  digit,  decimal 
point,  or  minus  sign;  it  continues  up  to  but  not  including  the 
first  character  which  is  not  a  digit,  decimal  point,  minus  sign, 
or  letter  "E."  Examples  of  character  strings  and  the  associated 
real  values  are  given  in  Table  12. 


21.  In  the  command  descriptions  that  follow,  “M,"  "N,"  and 
"  K  "  refer  to  Integer  values  and  “ S , "  "  T , "  “U,"  and  "V"  refer  to 
real  values.  Numeric  strings  of  the  type  described  above  should 
be  typed  within  the  command  at  these  points.  In  all  commands 
only  the  first  character  is  mandatory,  and  that  character  deter¬ 
mines  the  command  being  used.  Any  other  characters,  including 
those  characters  that  spell  out  the  command  in  English,  may  be 
used  freely.  Note  however,  that  the  characters  "A,"  "H,”  ”S," 

“V,"  and  "N,"  when  they  appear  anywhere  in  the  command  other  than 
the  first  character,  cause  additional  effects.  This  is  explained 
in  the  suffix  characters  section. 


Table  12 

Command  Value  Examples 


Character  String  Numeric  Value 


1 

-2  .  34 
4. 56E-3 
.0  1 

2E4 
1  E-4 


1  .00 

-2.34 

4.56*10(_3) 

.01 

2.00*104 

1 .00*10(-4) 


22.  The  numeric  fields  within  commands  may  be  delimited 
with  arbitrary  nonnumeric  characters.  A  typical  delimiter  char¬ 
acter  could  be  a  blank,  comma,  slash,  or  equal  sign.  The  actual 
character  chosen  would  depend  upon  ease  of  typing  and  the  subjec¬ 
tive  preference  for  readability. 

Basic  Commands 


23.  The  following  descriptions  of  the  DIRECT  commands  was 
originally  written  by  Bob  Conley  of  AFWL.  WES  personnel  have 
modified  the  descriptions  somewhat  to  match  modifications  to  the 
system  and  format  of  this  report. 
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KND 

This  command  terminates  DIRECT  execution. 

BAUD  M 

This  command  informs  direct  of  the  line  speed  currently 
being  used.  This  command  must  be  used  if  the  BAUD  rate  is 
not  equal  to  1200;  otherwise,  portions  of  the  plots  may  be 
lost  during  screen  erase,  or  undefined  results  will  occur 
during  hard  copy  generation. 

PLOT 
PLOT  M 
PLOT  M  N 
PLOT  M  N  K 

The  "PLOT"  command  is  used  to  display  a  plot  or  range  of  plots 
on  the  terminal  screen.  If  both  M  and  N  are  present,  then  all 
plots  with  plot  numbers  from  M  to  N,  inclusive,  will  be  dis¬ 
played.  If  M  is  absent,  then  all  plots  in  the  file  will  be 
displayed.  If  K  is  present,  then  both  M  and  N  are  required 
to  be  present  also.  In  this  case,  the  three  values  work  the 
same  way  as  the  Implied  "DO”  notation  in  FORTRAN  and  plots 
numbered  M,  M+K,  M+2K,  ....  are  displayed;  the  last  plot  in 

the  range  to  be  displayed  will  have  plot  number  less  than  or 
equal  to  N.  When  a  range  of  plots  is  displayed,  there  will  be 
no  pause  between  plots.  The  characters  "R,”  "H,"  " S , ”  "V,"  and 
"N"  may  be  used  to  select  additional  attributes  for  the  displayed 
plots.  See  the  suffix  characters  description  below  for  an 
explanation  of  the  effects. 

+  M 
-M 

These  commands  are  used  to  display  a  plot  whose  number  is  M 
greater  than  or  M  less  than  the  plot  number  of  the  last  dis¬ 
played  plot.  If  M  is  absent,  a  default  value  of  1  is  assumed. 

(It  no  plot  has  been  displayed,  then  the  last  displayed  plot 
number  is  zero.)  The  characters  "R,"  "H,"  ” S  , "  "V,”  and  "N” 

may  be  used  to  select  additional  attributes  for  the  displayed 

plot.  See  the  suffix  characters  description  below  for  an 
explanation  of  the  effects. 

COPY 
COPY  M 
COPY  M  N 
COPY  M  N  K 

The  COPY  command  Is  used  to  display  a  plot  or  range  of  plots 
on  the  terminal  screen  and  produce  hard  copy  on  the  hard  copy 

unit.  The  effects  of  "M,"  '  N  ,  "  and  "K"  are  the  same  for  the 

COPY  command  as  for  the  PLOT  command.  The  characters  "R," 
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" H ,  ”  "S,"  ”  V  ,  "  and  " N "  nay  bo  used  to  select  additional  attri¬ 

butes  for  the  displayed  plots.  See  the  suffix  characters 
description  below  for  an  explanation  of  the  effects. 

SOFTWARE 

The  SOFTWARE  command  is  used  to  select  software  character 
generation.  This  command  will  remain  in  effect  until  changed 
by  the  HARDWARE  command,  and  overrides  any  software  or  hard¬ 
ware  commands  within  the  file.  The  software  characters 
should  be  used  when  the  exact  size  and  orientation  of  characters 
are  desired.  Since  software  characters  are  produced  by  drawing 
each  line  segment  of  the  character  as  a  small  vector,  the  time 
required  to  complete  a  displayed  plot  is  considerably  greater 
than  that  with  hardware  characters. 

HARDWARE 

The  HARDWARE  command  is  used  to  select  hardware  character 
generation.  This  command  will  remain  in  effect  until  changed 
by  the  SOFTWARE  command,  and  overrides  any  software  or  hard¬ 
ware  commands  within  the  file.  The  hardware  characters 
are  used  when  the  exact  size  and/or  orientation  is  not  important 
in  the  displayed  plots.  Most  terminals  have  very  restricted 
capability  in  the  hardware  generation  of  characters,  but  the 
plots  are  displayed  extremely  rapidly  when  hardware  characters 
are  selected.  Hardware  characters  are  selected  by  default 
until  the  first  occurrence  of  a  software  command. 


QUERY 


The  QUERY  command  will  cause  the  current  date,  time,  baud 
rate,  hardware  or  software  character  status,  accumulated  CPU 
time  for  this  DIRECT  execution,  plot  number,  screen  parameters, 
region  parameters  (if  defined),  and  certain  model  number 
parameters  to  be  displayed  on  the  terminal. 

REGION  S  T  U  V 

The  REGION  command  explicitly  defines  a  region  rectangle. 

The  parameters  S,  T,  U,  and  V  are  in  the  coordinate  system 
of  the  screen  rectangle  (these  units  are  displayed  in  the  QUERY 
command);  the  screen  rectangle  is  defined  by  a  call  to 
subroutine  SCREEN  in  the  program  that  generated  the  file 
being  viewed.  "  S"  and  ”  T "  are  the  minimum  and  maximum  X  - 
axis  values  and  " l! ”  and  "  V  "  are  the  minimum  and  maximum  Y - 
axis  values  for  the  region.  The  relation  of  screen  and 
region  is  illustrated  in  the  following  diagram. 

Once  a  region  has  been  defined,  the  ”  R "  suffix  may  be  vised 
to  cause  the  plots  to  be  displayed  with  the  region  plotted 
to  fill  the  terminal  or  plotter  display.  See  the  suffix 
characters  below  for  an  explanation  of  the  effects. 
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MAGNIFY  S 

The  MAGNIFY  command  is  used  to  implicitly  define  a  region. 

The  magnification  factor  (in  diameters  of  magnification)  is 
given  by  "S."  After  this  command  is  sent,  a  graphics  cursor 
(either  cross  hairs  or  a  blinking  arrow)  will  appear  on  the 
terminal.  The  cursor  should  be  positioned  to  the  point  which 
is  to  become  the  center  of  the  region,  and  then  the  space 
bar  is  pressed.  Some  terminals  also  need  the  carriage  return 
key  to  be  pressed  after  the  space  bar  is  pressed;  you  can  tell 
if  the  carriage  return  is  needed  by  observing  the  result  of 
pressing  the  space  bar.  If  the  graphics  cursor  becomes  an 
alpha  cursor  (a  rectangular  cursor  which  may  or  may  not  blink) 
at  the  same  location  as  the  graphics  cursor,  then  the  carriage 
return  must  be  pressed.  If  the  graphics  cursor  becomes  an 
alpha  cursor  at  the  left  edge  of  the  terminal  screen,  or  if 
no  alpha  cursor  is  displayed,  no  carriage  return  is  needed. 

The  region  will  be  defined  with  a  center  point  at  the  point 
specified,  and  such  that  the  region  represents  the  desired 
magnification  of  the  screen.  Once  a  region  has  been  defined, 
the  ” R ”  suffix  may  be  used  to  cause  the  plots  to  be  displayed 
with  the  region  made  to  fill  the  terminal  or  plotter  display; 
see  the  suffix  characters  description  below  for  an  explana¬ 
tion  of  the  effects. 

The  MAGNIFY  command  will  cause  whatever  image  is  displayed  to 
be  magnified.  If  the  terminal  has  an  already  magnified  image, 
the  MAGNIFY  command  will  cause  that  image  to  undergo  magnifica¬ 
tion,  resulting  in  a  cumulative  magnification  of  the  original 
screen.  Magnification  values  less  than  1.0  cause  less  magnifi¬ 
cation.  However,  the  cumulative  magnification  may  never  he 
less  than  1.0;  if  such  a  reduction  is  needed,  the  REGION 
command  is  the  only  way  to  achieve  it.  In  this  case,  the 
region  parameters  are  entered  to  define  a  region  larger  than 
the  screen  rectangle. 

Suffix  characters 


The  effects  of  the  basic  commands  “+,“  "Plot,”  or  "  ,  " 

may  be  modified  using  suffix  characters.  The  suttix  characters 
may  appear  anywhere  in  the  command  except  at  the  tirst  character 
position,  which  always  must  be  the  basic  command  character. 
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Each  command  may  be  modified  by  any  number  of  the  suffix  charac¬ 
ters,  providing  two  mutually  exclusive  operations  are  not  speci¬ 
fied  in  the  same  command.  For  example,  it  makes  little  sense  to 
use  the  "S"  and  "H"  suffix  characters  in  the  same  command  because 
one  cannot  select  software  and  hardware  characters  at  the  same 
time. 


If  a  region  has  been  defined  with  either  the  REGION  or  MAGNIFY 
command,  the  " R "  suffix  causes  the  region  to  fill  the  terminal 
or  plotter  display  area.  If  the  "R"  suffix  character  is  not  used 
then  the  entire  screen  rectangle  will  be  made  to  fill  the  display 
area.  For  example,  the  command  P  3  R  would  cause  plot  number  3 
to  be  displayed  so  that  the  region  fills  the  terminal  display 
area. 


The  "H"  suffix  character  will  cause  hardware  characters  to  be 
selected  prior  to  displaying  the  plot.  The  character  mode  will 
remain  hardware  until  a  SOFTWARE  command  or  an  "S”  suffix 
character  is  encountered.  The  "H"  suffix  allows  hardware  char¬ 
acters  to  be  selected  on  a  plot-by-plct  basis,  within  the 
command  causing  the  display.  It  eliminates  the  need  to  enter  a 
separate  HARDWARE  command. 


The  S"  suffix  character  will  cause  software  characters  to  be 
selected  prior  to  displaying  the  plot.  The  character  mode  will 
remain  software  until  a  HARDWARE  command  or  an  ”H"  suffix 
character  is  encountered.  The  "  S "  suffix  allows  software  char¬ 
acters  to  be  selected  on  a  plot-by-plot  basis,  within  the 
command  causing  the  display.  It  eliminates  the  need  to  enter  a 
separate  SOFTWARE  command. 


The  V  suffix  character  will  prevent  the  screen  from  being 
erased  before  the  next  plot  is  displayed;  it  therefore  causes 
plots  to  be  over  laved. 


The  "N"  suffix  character  is  used  only  with  the  COPY  command. 
Normally  the  COPY  command  causes  the  hardcopy  to  be  generated 
before  the  plot  nimbi  line  is  added  at  the  top  of  the  terminal 
display  area.  The  "  ’  "  suffix  will  cause  the  plot  number  line 
to  be  generated  before  the  automatic  hard  copy  is  produced. 

This  Is  use!  til  in  causing  the  hard  copies  to  he  numbered. 
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HART  III:  PLOTTING  PROGRAMS 


24.  Plotting  programs  are  listed  in  Table  11.  Descriptions 
of  the  programs  and  user  instructions  for  some  of  them  are  con¬ 
tained  in  the  addenda  to  this  appendix  and  others.  If  a  program's 
primary  purpose  is  to  create  a  plot,  it  has  been  included  here. 

If  it  produces  a  plot,  hut  its  primary  purpose  is  some  other 
task,  the  program  is  described  in  one  of  the  other  appendices. 

See  the  program  index  in  the  main  volume  to  locate  user  instruc¬ 
tions  for  each  program. 

Plotting  Finite  Element  Meshes 

25.  The  plot  file  tor  the  finite  element  mesh  is  produced 
by  the  batch  program,  GFGEN.  Details  are  provided  in  APPENDIX  I): 
finite  Element  Network  Generation.  After  the  plot  file  is  created 
and  saved,  using  PROCLV,  it  can  be  directed  to  a  graphics  termi¬ 
nal  for  plotting  by  using  the  instructions  in  paragraph  8  of  this 
appendix.  An  example  result  is  shown  in  Figure  II. 

2b.  A  GFGKN  plot  file  contains  one  to  five  plots: 

Description _ 


The  mesh 

The  mesh  plus  element  numbers 

The  mesh  plus  node  numbers 

The  mesh  with  element  material 
types  (  1 M  A  T )  labeled 

The  mesh  with  corner  node  bed 
elevations  labeled 

27.  For  information  leading  to  the  creation  oi  the  GFGKN 
mesh  and  plot  tile,  see  Appendix  I)  in  this  document. 

Plotting  Results 

28.  Programs  CONTOUR,  VPLOT,  DROGUE  P  LT ,  4V1EW,  and  SEDGRAPH 
are  used  to  produce  graphical  output  from  model  results.  CONTOUR 
produces  contour  maps  of  any  model  output  and  is  described  in 
Addendum  1  -  1  . 

29.  Programs  VPLOT  (Addendum  1-2)  and  DROCUKPLT  (Addendum 
1-3)  are  used  to  plot  KMA-2V  velocity  results.  VPLOT  creates  a 
file  of  vector  plots  showing  current  speed  and  direction  as 
arrows.  Figures  12  and  13  show  examples.  DKOGUEPLT  creates  a 
plot  tile  showing  the  path  o  t  a  drogue  that  has  horn  transported 
by  currents  calculated  by  KMA-7V.  An  example  drogue  plot  is 
shown  in  Figure  14. 
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30.  Program  4VIEW  produces  quasi-3-D  plots  of  DMS-A  gridded 
data.  Each  plot  contains  views  of  the  data  from  four  directions. 
Its  use  is  described  in  Addendum  1-4  and  an  example  is  given  in 
Figure  15. 


31.  Program  SEDGRAPH  is  used  to  display  STUDH  results  of 
bed  elevation  change  or  concentration  as  shown  in  Figure  16.  The 
program's  use  is  described  in  Addendum  1-5. 
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ADDENDUM  I —  1  :  USER  INSTRUCTIONS  FOR  PROGRAM  CONTOUR 


Pur  pose 

I.  CONTOUR  is  a  batch  program  for  contouring  output  from 
the  TABS-2  system.  The  Input  can  be  uniformly  gridded  or  it  can 
have  the  random  spacing  of  the  finite  element  mesh. 


Origin  of  the  program 

2.  The  program  was  developed  by  Mr.  D.  P.  Bach  of  WES. 
The  gridding  subroutines  LOCATE,  POINT,  and  their  subordinate 
subroutines  were  written  by  the  staff  of  Resource  Management 
Associates.  All  graphical  output  is  produced  by  the  Graphics 
Compatibility  System  (GCS)  which  was  supplied  by  the  WES 
Automated  Technology  Center  and  modified  by  Mr.  Bach. 


Description 


3.  CONTOUR  will  accept  data  from  GFGEN ,  RMA-2V,  RMA-4,  STUDH , 
ELEVGRD,  and  TRANSA  and  produce  plot  files.  The  RMA-3  subroutine 
LOCATE  and  subroutine  POINT  are  used  to  grid  the  output  from  the 
finite  element  models.  All  graphical  output  is  written  by  the 

GCS  Library  using  the  GCSMET  driver.  Output  is  directed  to 
Tektronix  type  terminals  using  METAPLOT  (META  in  PROCLV)  and  to 
Calcomp  using  (METAB  in  PROCLV). 

4.  CONTOUR  will  contour  bed  elevations  from  a  GFGEN  output 
file.  It  will  also  contour  water-surface  elevations,  depths,  or 
velocities  from  the  RMA-2V  output  file.  It  can  contour  any  type 
of  data  that  has  been  created  with  ELEVGRD  or  TRANSA.  CONTOUR 
will  also  contour  bed  changes  or  sediment  concentrations  from  a 
STUDH  output  file.  It  can  contour  the  first  constituent  in  an 
RMA-4  output  file.  When  interpolating  model  results,  it  uses  the 
same  slope  functions  that  were  used  in  the  model  solution;  thus, 
it  exactly  reproduces  that  solution  for  contouring. 


Use 


5.  CONTOUR  requires  a  card  image  data  file  and  either  one 
or  two  binary  data  files,  depending  on  the  source  of  data  to  be 
contoured.  Table  I  —  1  —  1  ,  Coding  Instructions,  shows  the  required 
files.  In  brief,  contouring  requires  a  finite  element  mesh 
file  plus  the  file  with  the  desired  results  from  RMA-2V,  RMA-4, 
or  STUDH.  GFGEN,  ELEVGRD,  and  TRANSA  data  can  be  contoured  with 
only  one  binary  file.  The  files  must  be  available  prior  to 
executing  CONTOUR. 
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6  .  The  program  produces  one  output  file  which  is  saved  by 
PROCLV.  The  user  can  then  direct  the  output  to  a  graphics  termi¬ 
nal  and/or  to  a  Calcomp  plotter.  A  job  summary  statement  is  sent 
to  the  line  printer.  If  a  “DUMP"  is  requested,  it  goes  to  the 
line  printer  also. 

Plot  size 

7.  The  plot  area  on  a  Tektronix  4014  screen  is  considered 
to  be  14.3  by  10.9  in.  The  hard  copy  unit  reduces  that  image 
size  to  8.5  by  6.5  in.  For  CALCOMP  devices,  the  size  is  8.5  by 
11  in.  Optionally,  CONTOUR  will  adjust  its  plot  size  in  an 
attempt  to  achieve  a  u s e r - s pe c i f ied  scale. 

Plot  orientation  and  scale 

8.  CONTOUR  does  not  permit  grid  rotation  and  it  calculates 
its  own  scale  if  the  user  does  not  override  with  the  PSCALE 
command  . 

Contour  values 

9.  Specific  contours  may  be  requested  or  the  starting 
value,  ending  value,  and  interval  may  be  prescribed.  Details  are 
given  in  the  coding  instructions  at  the  end  of  this  section. 

Execut ion 

10.  CONTOUR  is  executed  with  PROCLV.  A  typical  command 
line  is  shown  in  the  APPENDIX  0:  PROCLV.  Current  procedure  may 
differ  slightly  and  can  be  listed  by  requesting 

BEGIN, HELP , PROCLV  .CONTOUR 

Plotting  does  not  begin  when  CONTOUR  is  executed.  The  output 
file  will  be  saved  by  PROCLV  and  can  be  attached  and  directed  to 
the  plotting  device  by  the  command  sequence  " BEG  I  N , M ET A , P ROCL V , 
plotfile." 


Examples 

Example  1 

11.  The  first  example  illustrates  the  CONTOUR  input  data 
required  to  contour  sediment  concentrations  that  were  calculated 
by  STUDH.  The  input  was  coded  into  a  permanent  file  called 
INCONDB  using  an  editor,  and  that  file  was  attached  to  CONTOUR  at 
execution  time  via  PROCLV.  The  contents  of  INCONDB  are 
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ATCHAFALAYA  MESH  12  (1967  DELTA) 
*C* , ,  'LINE' ,  5. , , 105. , , 10 


12.  These  two  Lines  contain  three  pieces  of  data.  The 
first  is  title  information  for  the  plot.  The  second  line  tells 
the  contour  program  the  data  file  to  be  contoured  is  Concentra¬ 
tions  and  thus  in  the  STUDH  output  format.  Also,  the  second  line 
of  data  tells  the  contour  program  the  smallest,  the  largest,  and 
the  interval  between  contour  lines.  These  commands  are  described 
below.  The  result  is  shown  in  Figure  I  —  1  —  1 .  Note  the  contour 
lines  are  numbered  and  the  legend  at  left  gives  the  concentration 
for  each  line  number. 

13.  Figure  1-1-2  is  a  magnification  of  the  area  around  X  = 
332500,  Y  =  210000.  This  plot  file  of  concentrations  was 
created  by  executing  CONTOUR  with  PR0CLV  as  follows: 

BEGIN,  CONTOUR,  PR0CLV,  BACH,  INCONDB,,  S30TBAY  ,  CONPLDB 

14.  The  STUDH  output  is  file  S30TBAY  and  the  output  contour 
plot  file  Is  CONPLDB.  Plotting  does  not  start  automatically. 
PROCLV  stores  CONPLDB  as  a  permanent  file  and  the  following 
command  is  required  to  direct  that  file  to  the  terminal. 

BEGIN,  META,  PROCLV,  CONPLDB. 

15.  The  terminal  will  respond  with  a  beep  and  the  message 
"READY”  on  the  screen.  It  is  then  under  control  of  METAPLOT  and 
commands  are  expected  from  the  keyboard  to  activate  plotting, 
these  are  described  in  METAPLOT  in  this  appendix. 

Example  2 


16.  An  example  of  plotting  bed  elevation  contours  from  an 
GFGEN  output  file  is  shown  in  Figure  1-1-3.  The  input  commands 
for  contour  are  coded  into  file  INCONDB  as  follows 

ATCHAFALAYA  MEST  12  (1967  DELTA) 

'BED  ELEVATIONS’  ,,' LINE'  ,  5 .  ,  ,  1  00  .  ,  ,  1  0  .  , 

'DUMP'  ,  ,  'NX'  ,200  ,  'NY'  ,200 

17.  This  input  will  cause  a  printout  of  gridded  data 
between  NX  =  1  to  200  and  NY  =  1  to  200  on  the  line  printer. 
CONTOUR  was  executed  with  PROCLV  by  typing 

BEGIN,  CONTOUR,  PROCLV,  BACH,  INCONDB,  AGOM  l  2  A  ,  ,  C  ON  P  1.  D  B 
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Card  Image  Data  Coding  Instructions 

18.  The  card  image  data  file  contains  the  plot  title  plus 

instructions  for  reading  the  binary  data  file(s)  and  setting  the 
contour  interval.  It  is  created  with  the  editor  and  saved  as  a 
"coded"  data  file,  rather  than  a  binary  data  file.  Table  I  —  1  —  1 
shows  the  coding  instructions,  the  sources  of  other  data  needed 
before  CONTOUR  can  be  executed,  the  disposition  of  the  output 
data  file,  and  the  command  syntax.  The  commas  indicate  a 

null  numeric  field.  Abbreviations  are  shown  below  each  command. 

19.  Please  note  the  different  style  of  these  card  input 
instructions  as  compared  with  those  in  the  main  programs.  After 
the  Title  line,  the  CONTOUR  program  expects  a  'command'  followed 
by  a  numeric  value.  The  command  should  be  set  off  by  the  apos¬ 
trophes  and  arguments  separated  by  commas.  (Kree-field  input 
structure.)  More  than  one  command  can  appear  on  a  line,  but  the 
line  length  should  not  exceed  80  columns. 
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T  «*  t»  1  e  I  -  1  -  l 
Coding  Instruct  Ions 


Ad  d  1  t  1  o  n  .1 1 


Funct Ion 

Input 

D  at  a  Required* 

Output  Ur i 

1.  Types  of  Data  That 

Can  Be  Con  to  u  r  e  di  : 

Bed  elevat Ions 

01  R  1 

PL  Cc) 

Depths 

01  K1 

0  l  R2 

Water  surface 

01  Rl 

0  1  R2 

- 

elevations 

Velocities 

01  Rl 

01  R2 

" 

E1.EVGRD 

01  KG 

■■ 

or  TRANSA  data 

Depth 

0  1  S  3 

.. 

changes 

Concentrations 

0  1  S  3 

“ 

First 

0  1  R  1 

01  R4 

- 

const  1 1  uent  on 
RMA4  file 

New  bed  elevations  01S3 

from  STUUH 

1 1 .  Contour  Instructions: 

Set  contour  window 
(not  valid  when 
using  ’ READ '  ,  . 

command 


Set  number  o 1 
lines  In  each 
direction 

Set  scale  factor 


Set  datum 


Control  Command 


’  Br  :■  ■  !>  V  A  I  1  css  1  .  .  <.  r 

’  11  ’  .  . 

(Note  that  tin-  "umirlr  t  i  <*  1  d  Is  "null  i 

*  UK  I'  PIS  *  ,  ,  u  r 

’  I)  V  '  ,  , 

’  WA11>  ELEVATIONS*,,  or 

'  UA  1 

’  VKl.'U;  1  I  1  I-  S  '  ,  ,  or 

'  V  '  ,  . 

'EI.EVGHD'.,  „r 

' E ' , .  or 

*  TRASSA  '  .  ,  or 

'  1  R  '  ,  , 

’DEPP!  C  H  A  N  ( .  K  S  ’  .  .  or 

1  DC  *  ,  , 

’ CONCf NTRAT  t  ONb  1  ,  ,  or 

•C  '  ,  , 

*  K  M  A  '•  '  ,  , 


‘NEW  BED  1  , 
*  NB  ’  ,  , 


'XM1N',  xmlnvalue,  (coordinate  value) 

' XMAX ’ ,  xraax va 1 ue , 

’  Y  M  1  N  '  ,  ymlnvaluc, 

'  YM AX '  ,  ymax va 1 ur  , 

The  numeric  field  here  specifies  a 
limit  along  one  of  the  two  major  axes 
In  Input  data  coordinates.  Defaults  ar 
maxim urns  or  mint  mums  found  on  the 
Input  tile. 

'NX',  number  o(  grid  lines  In  x-dlrectlon 
’NY’,  number  o!  grid  lines  In  y -direct  Ion 
Default  -  100. 

Maximum  ■  500 . 

'  S  C  A 1 .  K '  ,  scale  value,  or 

•SC’,  scale  value. 

Default  •  1.0 

DATA  «  DATA*  SCALE  DAT  I'M 
1  I)  AT  I '  M  *  ,  datum  value,  or 

*  1)  A  '  ,  datum  value, 

Default  »  O.o 

DATA  -  DAT  A* SCALE* UATUN 


C  R  A  P  H  I  C  S  /  C  ON  TO  I!  R 


^V-  *. 


L  • 

s’'.-- : 

V  ~ 


b 


b 


r 


fW  y  >yijyn  Ui  pyHH^I  j  i  ^|«»iw  i  .■  I  « 


■«■»■  ■  ■  *  *»7  ry "  mu 


\ 
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TABLE  1-1-1  (continued) 


F unction 


Produce  grid  swath 
dump 


Define  Individual 
Contour  line 
Define  contour  lines 
by  "DO-LOOP' 

•et hod 

Select  t 1  west ep  to 
use 


Distort  plot  to  fill 
screen 


Additional 

Input  Data  Required*  Output  Wr 1 1 1  e n  * 


Kun  Control  Cam  and 


Swath  daap 
(like  DUMP  E  R  2 ) 
on  line  printer 


Plot  (0UTC0N) 


1  DUMP  •  ,  value, 
o  r 

'Dll’,  value, 
whe  re 

value  -  0  for  dump  of  data  to  be  contouied. 

1  for  dump  of  element  assignments 

to  each  grid  point 

2  for  both  options  above 

'LINE',  contour  value,  or 

' L  *  ,  con  t our  value, 

'LINE ‘ ,  start  value,,  end  value,,  increment, 
or 

'L',  start  value,,  end  value,.  Increment, 
'TIME STEP',  time-step  number,  or 
'XI'.  time-step  number. 

Default  -  last  time-step 
(Numbering  starts  at  1) 

‘DISTORT ' , , 


Scale  plot 

Ill.  ?l\e  Handling  \  nsl  r  uct  1  ont 


Read  intermediate 
grid  array 
(Not  valid  for 
f.l  F.VCRO/TRANSA 
contouring) 

Write  Intermediate 
grid  array 
(Not  valid  for 
f.lkvcrd/transa 

contouring) 

Write  ELEVCRD/ 
TRANSA  type 
file 


LOCATE  Information 
from  previous 
CONTOUR  run 

(SVC) 


'PSCALE',  plot  scale, 
DEFAULT  -  self  scaled 


Locate  Infor¬ 
mation  to  use  In 
subsequent  runs 
(SVC) 

PI ot  (outcon  ) 
P.LEVCRn  file  (ELC.) 
Plot  (outcon) 

DM S - A  file 
FEG  file 


READ*  ,  , 

This  option  Is  used  to  save  computer 
time  by  avoiding  calling  LOCATE,  which 
maps  elements  onto  grid  locations 
Must  first  ‘SAVE1  the  file. 

SAVE*  ,  , 

This  option  is  used  to  save  computer 
time  by  avoiding  the  use  of  LOCATE. 


WRITE',  scale, 

This  option  can  be  used  to  send  gtldded 
data  to  programs  such  as  4-VIEW  and 
BATHVOL-  It  can  also  be  used  to  “hot- 
start"  CONTOUR,  avoiding  the  grid  ding 
process  while  experimenting  with  different 
contour  values. 


*  See  Table  N7  in  Appendix  N  for  explanation  of  the  file  codes. 


/m 

*  v  ■ 
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ADDENDUM  1-2:  USER  INSTRUCTIONS  FOR  PROGRAM  VPLOT 


Purpose 


1.  VPLOT  creates  a  plot  file  of  velocity  vectors  from  RMA- 
2V  results.  It  will  plot  at  all  nodes  in  the  finite  element 
mesh,  plot  at  selected  nodes  only,  or  interpolate  onto  a  regular 
grid  and  plot  the  interpolated  velocities. 


Origin  of  Program 


2.  The  original  VPLOT  program  was  obtained  from  the  Ohio  River 
Division,  Corps  of  Engineers,  in  connection  with  the  Edinger 
Model.  The  Corps'  Hydrologic  Engineering  Center  (HEC)  modified 
that  program  to  be  compatible  with  the  Resource  Management  Asso¬ 
ciates  ( RMA)  2-D  finite  element  hydrodynamic  models.  The  inter¬ 
polation  scheme  was  added  by  WES,  using  shape  functions  from  RMA- 
3  —  a  program  originally  written  by  RMA.  Subsequent  modifica¬ 
tions  have  been  made  by  WES  personnel. 


Description 


3.  VPLOT  is  a  batch-oriented  program  that  reads  GFGEN  and 
RMA-2V  output  files  and  creates  a  velocity-vector  or  unit 
discharge-vector  plot  file  using  the  METAPLOT  system  (i.e., 
Calcomp  look-alike  calls).  The  length  of  the  vector  is  scaled  to 
the  magnitude  of  the  velocity  or  unit  discharge,  the  direction 
shows  direction  of  flow,  and  the  base  of  the  vector  is  plotted  at 
the  node.  Unless  instructed  otherwise,  VPLOT  will  plot  a  vector 
at  every  node  in  the  finite  element  mesh;  however,  nodes  can  be 
selected  or  a  uniform  grid  can  be  interpolated  if  desired. 
Interpolation  utilizes  the  RMA-2V  shape  functions  so  the 
interpolated  results  are  exactly  as  calculated  by  RMA-2V. 

4.  Only  these  nodes  inside  the  wet  portion  of  a  mesh  will 
be  plotted.  External  boundaries  can  be  drawn  at  the  option  of 
the  user. 

5.  A  plot  file  can  be  directed  to  a  Calcomp  device  where 
the  plots  may  be  scaled  to  overlay  the  base  map  and/or  the  file 
may  be  directed  to  an  Interactive  terminal. 


Plot  size 


6.  The  plot  area  on  a  Tektronix  4014  screen  is  considered 
to  be  14.3  by  10.9  in.  The  hard  copy  unit  reduces  that  image 
size  to  8.5  by  6.5  in.  CALCOMP  plot  sizes  are  user-specified. 
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Plot  orientation  and  scale 


7.  The  term  plot  orientation  refers  to  the  alignment  of  the 
(x,y)  axis  of  the  mesh  with  the  (x,y)  axis  of  the  plotting  de¬ 
vice.  The  x-axis  of  the  graphics  device  is  longer  than  the  y- 
axls.  When  the  finite  element  mesh  is  longer  in  the  x-direction 
than  it  is  in  the  y-direction,  the  best  utilization  of  plotting 
space  corresponds  with  the  problem  shape.  However,  when  the 
study  area  is  longer  in  the  y-direction  than  in  the  x-direction, 
plotting  space  is  wasted.  VPLOT  allows  the  (x,y)  axis  of  the 
mesh  to  be  rotated  to  best  utilize  plotting  space.  The  amount  of 
rotation,  which  can  be  any  angle,  is  prescribed  in  degrees 
with  the  default  being  zero.  The  coordinates  of  the  mesh  are 
modified  as  shown  below  with  all  plotting  and  scaling  being 
referenced  to  that  rotated  mesh. 


XR  = 

CORD( J , 1 ) *  COSAR 

+  CORD( J ,2)*SINAR 

YR  = 

C0RD(J,2)*C0SAR 

-  CORD( J, 1 )*SINAR 

whe  re 

CORD( J  ,  1  ) 

=  the 

x-coordinate  at 

node  J 

CORD( J  ,  2) 

»  the 

y-coord inate  at 

node  J 

SINAR 

■  Sin 

(ARR) 

- 

COSAR 

*  Cos 

(ARR) 

ARR  *  azimuth  of  rotated  y-axis  in  radians 


8.  Two  scales  are  established:  (a)  the  scale  for  plotting 

the  rotated  (x,y)  axis  and  (b)  the  ve 1 o c  i  t y- v e c t o r  length  scale. 
Regarding  the  space  scale,  VPLOT  will  either  scale  the  XR-  and 
YR-dimens  ions  of  the  study  area  to  fit  the  plotting  area,  or  the 
scales  can  be  supplied  by  the  user.  In  either  case,  the  mesh 
size  is  converted  into  inches  as  follows: 


XC  =■  (XR  -  XZE  RO )  /  XS 
YC  =  (YR  -  YZE  RO ) / YS 

whe  re 

XC.YC  =  plotting  positions  of  the  nodal  point 
coordinates  in  inches 

XR, YR  =  the  rotated  mesh  coordinates  in  prototype  units 

XS, YS  *  the  x-axis  and  y-axis  scales  in  prototype  units 

per  inch 

C.KAPH  ICS/Vl’I.OT  1-2-2 
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XZERO  =  the  smallest  XR-coordinate  in  the  mesh 
Y  Z  E  R  0  =  the  smallest  YR-coordinate  in  the  mesh 

9.  VPLOT  calculates  vector  length  by  scaling  the  u-  and  v- 
velocity  components  as  follows 

H  =  u/HS 
V  =  v/VS 

where 

H  =  calculated  plot  length  for  the  x-component  of 
velocity  vector,  inches 

HS  =  plotting  scale  for  the  u-component  of  velocity, 
fps/lnch 

u  =  calculated  x-component,  fps 

V  =  calculated  plot  length  for  the  u-component  of 
velocity  vector,  inches 

VS  =  plotting  scale  for  the  v-component  of  velocity, 
f  p  s  /  i  n  c  h 

v  =  y-component  of  velocity,  fps 

in.  Whin  axes  have  been  rotated,  the  velocity  vector 
c  o  m  pu  n  e  11  •.  s  are  also  rotated  prior  to  plotting  as  follows 

ItR  =»  H  *  C  0  S  A  R  +  V*  S I N  A  R 
VK  =  V*  COS  AR  H*  S  I  N AR 

wlu  r  e 

H,V  1  described  above 

0 O S A R  =  Cosine  of  file  azimuth  of  the  rotated  coordinate 
a  x  e  s 

S1NAK  =  sine  of  the  aximuth  of  the  rotated  coordinate 
axes 

The  base  of  the  velocity  vector  is  plotted  at  ( X  C , Y  C )  and  the  tip 
of  the  arrowhead  is  plotted  at  (XC+HR,  YC+VR). 
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11.  To  highlight  zones  of  velocity  greater  than  the  maximum 
scale  length,  a  solid  arrowhead  will  be  displayed  when  either  the 
u-  or  the  v-component  exceeds  a  “maximum  value”  that  is  pre¬ 
scribed  in  the  input  data  as  VECMAX  ( J 1  —  7 ) . 


Use 


12.  VPLOT  requires  one  to  three  input  data  files  and  pro¬ 
duces  one  output  file,  summarized  in  Table  1-2-1.  All  input 
files  must  be  created  before  executing  VPLOT. 

13.  Graphs  are  not  displayed  when  VPLOT  is  executed;  the 
plot  file  is  created  and  saved.  It  is  then  ready  to  be  directed 
to  plotting  devices  by  using  METAPLOT. 


Table  1-2-1 

Summary  of  Files  for  VPLOT 


Description  of  Data 


Input 

Mesh  data 

Hydraul  ic  data 

Card  image  input  data 


Source/ File  File  Type 


GFGEN/01R1  Binary 
RMA-2V/01R2  Binary 
Editor  Coded 


Output 

Velocity  vector  plot  VPLOT/PLVP  Binary 

file 


*See  Table  N7  in  Appendix  N  for  explanation  of 
file  codes. 


14.  VPLOT  is  executed  with  PROCLV.  A  typical  command  line 
is  shown  in  the  APPENDIX  0:  PROCLV.  Current  procedure  may  differ 
slightly  and  can  be  listed  by  requesting 


BEG IN, HELP, PROCLV, VPLOT 


15.  Plotting  does  not  begin  when  VPLOT  is  executed.  The 
VPLOT  output  file  will  be  saved  by  PROCLV  and  can  be  attached  and 
directed  to  the  plotting  device  by  METAPLOT. 

16.  VPLOT  writes  a  short  printout  back  to  the  line  printer 
separate  from  the  plots. 
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Example 


17.  The  following  Card  Image  Input  data  file  produced  the 
vector  plot  shown  on  Figure  1-2-1. 


T  1 

LITTLE 

ROCK  AIRPORT 

RUNWAY 

EXTENSION - ARKANSAS 

J  l 

1  .0 

1 

.0 

0. 

0. 

10 

. 

J  2 

3 

0 

0 

0 

1 

xs 

_ 

1 .0 

ITYPE 

3 

YS 

= 

1.0 

ISEL 

= 

0 

HORIZ 

= 

0  . 

I PNN 

= 

0 

VERT 

= 

0. 

ISTEPS 

0 

HHS 

10. 

I  BOUND 

= 

1 

VVS 

10. 

ITONLY 

0 

VECMAX 

= 

15.0 

10. 


15.0 


Instructions  for  Coding 
Card  Image  Input  Data 


18.  The  input  data  should  be  coded  in  eight  column  fields 
with  the  card  type  coded  in  columns  1  and  2.  The  instructions 
that  follow  show  details.  Variable  names  appearing  in  the  input 
are  shown  in  Table  1-2-2.  A  list  of  the  input  card  images  is 
given  in  Table  1-2-3. 
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1 

1 

2 

N 

W 

G 

T 

N 


Table  1-2-2 

Summary  of  Variable  Names  on  Input  Cards 


Variable 

Card 

Variable 

Card 

AR 

J1 

NODLST 

PN 

NPXMAX 

VW 

HHS 

J  1 

NPXMIN 

VW 

HORIZ 

J  1 

NPYMAX 

VW 

NPYMIN 

VW 

I  BOUND 

J  2 

l BNPLT 

J  2 

TITLE 

T  1 

ICG 

all 

TPL 

VT 

IN 

VN 

VECMAX 

J  1 

INODES 

J  2 

VERT 

J  1 

I  PNN 

J  2 

VVS 

J  1 

NX 

RG 

ISEL 

J  2 

NY 

RG 

I  STEPS 

J  2 

XS 

J  1 

ITONLY 

J  2 

ITYPE 

J  2 

YS 

J  L 

Table  1-2-3 

Sequence 

of  Card  Image  Input 

_ Con  ten  t _ 

Title  for  plots 

Scaling  and  orientation  parameters 
Run  options 

Nodesat  which  vectors  are  to  bedrawn 
Plot  window 

Regular  grid  intervals 

Times  at  which  plots  are  to  be  drawn 
Pinpoint  location  of  a  node 


Required? 

Yes 

Yes 

Yes 

If  ITYPE  =  1 

If  ITYPE  =  12 
If  ITYPE  <  0 
If  ITONLY  >  0 
No 
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T1  Card  Title  Card  Required 

Record  title  Information  on  one  card. 

Field  Variable  Value  _ Description _ 

0  T1  Card  identification. 

1-3  TITLE  Enter  up  to  20  character  plot  title 


GRAPHICS  /V  i'1.1!  r 


I  -  2  -  R 


0  4/85 


J 1  Card 


Field 


Job  Parameters 


Required 


Variable 


Value 


HORIZ 


VECMAX 


Description 


Card  group  identification 

Scale  factor  for  the  x-axis  of  the  mesh 
(Code  as  1666.67  for  1:20,000  scale  map 
i.e.  ,  20,000/  1  2  =  1666.67  ) 

Program  will  search  HORIZ,  VERT  then 
YS  for  use  as  x-axis  scale  for  mesh 

Scale  factor  for  the  y-axis  of  the  mesh 
when  creating  a  distorted  plot  (not 
re  commended ) 

Program  will  search  for  HORIZ  VERT  then 
XS  for  use  as  the  y-axis  scale  for  the 
mesh 

Maximum  plot  size  in  inches  for  the 
x-axis  of  the  mesh.  If  coded  HORIZ 
will  override  XS 

Program  will  search  VERT,  then  XS 
for  the  x-axis  scale  for  the  mesh 

Maximum  plot  size  in  inches  for  the 
y-axis  of  the  mesh.  If  coded,  VERT 
will  override  YS 

Program  will  search  HORIZ  then  YS  for 
the  y-axis  scale 

Code  the  x-velocity  scale  factor  in 

f e e t / s e c / i n c h  of  plot  (i.e.,  5=5  f ps 
per  inch  of  Calcomp  plot;  5=5  fps 
per  1/2  inch  Tektronix  4014  plot) 


Code  the  y-velocity  scale  factor. 
For  undistorted  plots,  VVS  =  HHS 


The  maximum  velocity  component  for 
open  arrowheads.  It  either  u  or 
v  velocities  exceed  VECMAX,  the 
arrowhead  is  shaded.  If  both  u  and 
v  velocities  exceed  VECMAX,  the 


GRAPHICS/VPLOT 


J1  Card  (continued) 


vector  is  set  at  45  deg  in  addition 
to  the  shaded  arrowhead 

8  AR  +,-  Azimuth  of  the  y-axis  of  the  mesh  in 

degrees  when  it  is  desirable  to  rotate 
the  vector  plot.  AR  is  measured  from 
the  y-axis  of  the  plotter  device  (i.e. 
vertical  on  Tektronix  and  across  the 
paperon  drum  plotter),  positive 
c 1 o  c  kw i s  e 

0  No  rotation 


GRAPH  ICS/VP  1,0T 
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04/85 


J  2  Card 

Job 

Control  Parameters 

Required 

Field 

Variable 

Value 

Description 

0 

ICG 

J  2 

Card  group  J2 

l 

ITYPE 

0,3 

1 

Type  of  vector 
Default,  full 
Plot  selected 

plot  requested 
finite  element  mesh  plot 
nodes,  finite  element  mesh 

2 

-2 


-3 


10 

20 

-20 

30 

-30 


ISEL 


Plot  selected  window,  finite  element  mesh 
Interpolate  from  finite  element  mesh 
onto  regular  grid  and  plot  selected 
w i nd  ow 

Interpolate  from  finite  element  mesh 

onto  regular  grid  and  plot  entire  space 
Type  of  pe r-un i t - w  i  d t h-d i s cha r g e  vector 
plot  requested 
Plot  selected  node,  Ft  mesh 
Plot  selected  window,  FE  mesh 
Interpolate  from  FE  mesh  onto  regular 
grid  and  plot  selected  window 
Plot  a  full  finite  element  mesh 
Interpolate  from  FF.  mesh  onto  a 

regular  grid  and  plot  a  full  finite 
element  mesh 

The  number  of  nodes  coded  on  VN 
cards.  Required  if  ITYPE  «  1 


Only  required  when  ITYPE  is  not  equal  to  1 


3  IPPN  0 


4  ISTEPS  0 

+ 


5  IBOUND  1 


0 

6  ITONLY  0 


Node  numbers  are  not  written  on 
the  plot  (preferred) 

Node  numbers  are  written  on  each 
node  plotted. 

Steady  state,  yields  1  plot 

Code  the  number  of  time-steps  in 

the  RMA-2V  dynamic  run  output  file 
for  which  a  vector  plot  is  desired 

Plot  the  external  boundaries  as  a 
solid  line  (preferred) 

Do  not  plot  external  boundaries 

No  VT  card  is  present 

Enter  the  number  of  time-steps 
coded  on  VT  cards 


1-2-1  1 


GRAPH ICS/VPL0T 


04/85 


Field  Variable  Value  _ Description _ 

7  1BNPLT  0  Do  not  plot  locations  of  boundary 

nodes 

+  Plot  locations  of  boundary  nodes 

8  INODES  0  Plot  vector  at  all  nodes  in 

specified  plot  area  (default) 

1  Plot  only  corner  nodes  in  the 

specified  plot  area 

2  Plot  only  midside  nodes  in  the 

specified  plot  area 


RAPIU  CS/VPPOT 
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VN  Card 


Selected  Nodes  for  Vector  Plots 


Opt  Iona  1 


Include  this  card  when  ITYPE  =  1  or  10  (J1  Card) 


Field 

Variable 

Value 

Description 

0 

ICG 

VN 

Card  group  identification  = 

VN 

1 

IN(  1  ) 

+ 

Enter  the  first  node  to  have 
vector  plotted 

the 

2 

I  N  (  2  ) 

+ 

Continue  coding  10  nodes  per 
all  nodal  points  have  been 
the  vector  plots 

card  until 
entered  for 

etc. 

Code  ISKL  <  J  2 - 2  )  nodes 
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VW  Card 


Rectangular  Window 


Opt ional 


Field 

Variable 

Value 

Description 

0 

ICG 

VW 

Card  identification  -  VW 

1 

NPXMIN 

+ 

The  node  number 
coordinate  in 

of  the  smallest  X' 
the  window 

2 

NPXMAX 

+ 

The  node  number 
coordinate  in 

of  the  largest  X- 
the  window 

3 

NPYMIN 

+ 

The  node  number 
coordinate  in 

of  the  smal lest  Y- 

the  window 

4 

NPYMAX 

+ 

The  node  number 
coordinate  in 

of  the  largest  Y- 
the  wi ndow 

Include  VW  card  when  1TYPE  -  121  or  1201  (J2  card) 


GRAPH  ICS /VPI.o  r 
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RG  Card 


Regular  Grid  Scale 


Optional 


Field 

Variable 

Value 

Desciption 

0 

ICG 

RG 

Card  group  definition  =  RG 

1 

NX 

+ 

Horizontal  axis  spacings  for  regular 
grid  plotting 

Default  =  50 

2 

NY 

+ 

Vertical  axis  spacings  for  regular 
grid  plotting 

De  f  aul t  =  2  5 

Include 

RG  card  when 

ITYPE  ( J  2 

card)  is  negative. 
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VT  Card 


Selected  Time  for  Vector  Plots 


Optional 


Field 

Variable 

Value 

Description 

0 

ICG 

VT 

Card  group  identification  =  VT 

1 

TPL( 1 ) 

+ 

Code  the  time  in  decimal  hours 
for  the  first  vector  plot 

2 

TPL( 2) 

+ 

Continue  coding  the  times  in  sequential 
order  until  ITONLY  values  have  been 
entered 

Include 

this  card  when 

ITONLY  ( J  2 

Card)  is  positive. 

CRAPHICS/VP1.0T 
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PN  Card 

Plot 

Node  Location 

Optional 

Field 

Variable 

Value 

Descript  ion 

0 

ICG 

PN 

Card 

group  identification  = 

PN 

1 

NODLST 

+ 

Code 

the  node  numbers  where 

you  want  a 

“  +  "  sign  plotted  for  references.  Up 
to  "MM3"  values  are  permitted.  Code 


continuation  cards  exactly  the  same  as 
the  first  card.  Program  will  count 
the  number  of  values  coded  and  stop 
automatically 
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ADDENDUM  1-3:  USER  INSTRUCTIONS  FOR  PROGRAM  DROGUE  P  LT 


Purpose 

1 •  D ROGUE P LT’s  purpose  Is  to  trace  the  movement  of  a  drogue 
with  time  when  placed  in  a  flow  field  computed  by  RMA-2V. 

Origin  of  Program 

2.  DROGUEPLT  was  written  by  J.  P.  Stewart  of  WES  using 
interpolating  routines  from  RMA-3,  which  were  written  by  Resource 
Management  Associates. 


3.  The  program  plots  the  movement  of  one  drogue  for  a 
maximum  of  25  hr.  A  maximum  of  400  nodes  may  be  used  to  describe 
the  land  boundary. 


4.  Results  at  the  finite  element  mesh  points  are  converted 
to  a  rectangular  grid  with  each  grid  cell  assigned  the  element 
number  within  which  it  lies.  The  rectangular  grid  is  used  to 
approximately  locate  which  element  the  drogue  is  occupying  at 
each  computation  interval.  The  drogue  coordinates  are  converted 
to  local  coordinates,  which  are  tested  to  see  if  they  lie  between 
-1  and  1.  If  so,  the  correct  element  has  been  located  and  the 
drogue  velocity  is  computed  using  the  shape  functions.  The  model 
results  time-step  increment  is  divided  into  36  equal  parts.  Thi 
drogue  is  moved  a  distance  equal  to 


TINCR 

x  =  Vx  36  and 


y  =  Vy 


TINCR 

36 


The  new  x  ,  y  coordinates  are  then  used  along  with  the  rec¬ 
tangular  grid  to  approximately  locate  the  element  within  which 
the  drogue  lies,  and  the  process  is  repeated. 

5.  If  the  local  drogue  coordinates  do  not  lie  between  -1 
and  1,  a  second  iteration  is  made  by  choosing  the  appropriate 
adjacent  element.  This  is  determined  by  checking  whether  the 
local  coordinate  is  less  than  -1  or  greater  than  1.  When  the 
correct  element  is  located,  the  drogue  velocity  is  computed  as 
described  above. 
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5.  DROGUKPLT  is  executed  from  PROCLV.  Card  Image  Run 
Control  input  is  described  below.  Required  input  includes  the 
GFGKN  geometry  file  (01R1)  on  logical  unit  3,  and  the  RMA-2V 
results  file  (01R2)  on  logical  unit  6. 


Card  Image  Data  Input  Instructions 


6.  Card  Image  run  control  data  input  is  described  in  the 
following  pages.  Input  is  fixed  format. 


GRAPH  I CS /DROGUE 
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Card  2.  (F10.0,  215) 


Timing  Control 


Required 


Name 

Value 

Description 

TI  NCR 

+ 

Length  of  velocity  input  time- 
steps  in  seconds 

NSTEPS 

+ 

Number  of  time-steps  to  be  read 
from  tape  unit  6 

ISTRT 

+ 

Time-step  at  which  the  drogue  is 
to  be  placed  in  the  water 

GRAPH  ICS /DROGUE 
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(2F10.0)  Initial  Drogue  Location 


Required 


Name  Value  _ Description 


XDR(l)  +  Initial  location  of  the  drogue 

YDR(l)  + 


1-3-5 


GRAPHICS/DROGUE 


04/85 


Card  4.  (315) 

Name  Value 
IPT 1  0 

1 

I  S  3 

IS6  + 


Job  Options 

_ Description _ 

No  grid  print 

Swath  dump  of  grid  is  printed 

Tape  unit  for  GFGEN  file 
(default  ■  3) 

Tape  unit  for  RMA-2V  file 
(default  =  6) 


Re 
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Hard  6.  (1615) 


Element  Control 


Required 


Name 


l  MAT 


Value 


Description 


Every  element  must  be  flagged. 

0  Element  Is  ignored 

1  Element  is  used  in  the  computation 


GRAPH!  CS/DROCUE 
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Land  Boundary  Control 
Value  _ Description 


+  Number  of  points  to  be  read 
describing  land  boundaries 


Required 
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Card 


MOTE  : 


set  8.  (1615)  Land  Boundary  Nodes 


Required 
if  NPTS  >  0 


Name  Value 


Description 


NBP(J)  +  Node  number  along  a  land  boundary 

9999  Flags  end  of  a  land  segment.  Used 

to  lift  plotter  pin  before  starting 
a  new  segment,  such  as  an  island 


Blank  End  of  land 
Use  as  many  cards  as  needed 


boundary  description 
to  describe  the  land  boundary 
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I  -  1-  1  0 


Card  set  9.  (10A8)  Axis  Titles 

Name  Value  _ Description _ 

HEADER  2  title  cards  to  appear  on  the 

plot.  Titles  should  be  centered 
in  an  80-column  field 
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ADDENDUM  1-4:  USER  INSTRUCTIONS  FOR  PROGRAM  4VIEW 


1.  Program  4  V  I  F.  W  is  a  batch  program  that  produces  3-D  line 
drawings  of  l)  M  S  -  A  gridded  data. 


2.  Input  to  4VIKW  consists  of  Card  Image  run  control  and  a 
gridded  data  file.  The  gridded  data  file,  input  as  logical  unit 
10,  is  in  the  format  produced  by  the  DMS-A  as  described  in 
Appendix  L. 

3.  Output  consists  of  a  plot  file  on  logical  unit  3. 

4.  4VIEW  is  available  through  PROCLV: 

BEGIN , 6V 1EW .PROCLV ,td,I3RP,Il4V,014V,rje  <CR> 

where  id  »  user's  name 

I3RP  -  DMS-A  gridded  data  file  name 
I  1 4 V  *  run  control  input  file  name 
014V  =*  plot  output  file  name 
rje  =  destination  of  printed  output 

5.  The  run  control  input  to  4VIEW  consists  of  one  card 
(line)  and  is  as  follows: 


Variable 
Number  Forma  t 


-  0  for 
a  1  for 
=  2  for 
*  3  for 
=  4  for 
View  for 
View  for 
View  tor 
Vertical 
Minimum  x 
Maximum  x 
Minimum  y 
Maximum  y 
Dimension 
of  page 
Pedestal 
where  a 


Description 


no  plot 

front 

rear 

right 

Left 

plot  number  2 
plot  number  3 
plot  number  4 

exaggeration  (scale  factor) 

-value  of  grid  to  be  plotted 

-value 

-value 

-value 

in  inches  of  long  dimension 
to  be  plotted  (28.0  Is  maximum) 
height  in  inches  (position 
rea  of  interest  is  to  be  drawn) 


View  for  plot  number  1 
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ADDENDUM  15:  USER  INSTRUCTIONS  EOR  PROGRAM  SEDGRAF 


Purpose 

1.  Program  SEDGRAF  displays  one  through  nine  ranges  of 

d e s po s l t i o n / e r o s i on  or  concentration  data  from  the  sediment  model 
(STUDU)  in  a  factor  map  display. 

Origin  of  the  Program 

2.  SEDCKAF  was  written  by  S.  A.  Adamec  of  WES. 

Use 

3.  The  irregularly  spaced  nodal  results  are  interpolated  to 
a  100  by  100  regular  grid.  For  each  plotting  range,  the  user 
must  specify  starting  and  ending  values  and  a  symbol  (such  as 

or  “l")*  The  symbol  It  is  reserved  for  land.  The  user  must 
specify  which  time-step  is  to  be  displayed  from  the  STUDH  results 
(if  you  want  the  last  time-step  of  a  run  that  lasted  20  time- 
steps,  you  would  specify  19  since  STUDH  runs  one  time- step  before 
producing  results)  and  the  component  to  plot  (^concentration, 

2=bed  change). 

4.  The  program  will  window  in  on  a  particular  area  of  the  mesh 
if  the  user  specifies  four  nodes  that  form  a  box  around  the  area 

of  interest. 

5.  SEDGRAF  requires  a  GFGEN  geometry  file  as  input  on 
logical  unit  1  and  a  STUDH  results  file  as  input  on  unit  2.  The 
card  image  input  data  are  read  from  unit  8  and  the  output 
METAFILE  (plot  file)  is  on  unit  99.  The  input  data  for  SEDGRAPH 
is  read  in  free-format.  All  fields  are  separated  by  commas  and 
the  symbols  for  each  range  must  be  enclosed  in  single  quotes 
('.’). 

6.  Letters,  numbers,  and  symbols  may  be  used  as  factor 
plotting  labels.  Commonly  used  symbols  are  letters  for  varying 
degrees  of  erosion  and  numbers  for  varying  degrees  of  deposition. 
When  plotting  concentrations,  it  is  advisable  to  also  include  a 
minus  sign  for  negative  concentrations  between  -0.01  and  -1000. 
to  warn  of  patches  of  negative  concentrations. 

7.  The  scale  of  plotting  chosen  may  mask  some  local  results 
because  of  averaging.  To  obtain  details  of  results,  windowing  is 
necessary. 
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Card  Image  Data  Input  Instructions 


Card  1  ( Free-Format )  NUMSTP , NCOM , X W I NDOW 

NUMSTP  *  The  number  of  the  data  record  to  be  displayed 
NCOM  -  The  component  to  plot  ( 1 -CONCENT RAT  1 ON , 2 -BE D  CHANGE) 
IWINDOW  =  Turns  windowing  on  or  off  (0=OFF,1=ON) 

Card  1A  (Free-Format,  Include  Only 

if  Window  from  Card  1  is  Equal  to  1)  NXMI N , NXMAX , NYMI N , N YMAX 

NXM1N  -  NODE  FOR  MINIMUM  X-COORDINATE 
MXMAX  =  "  "  MAXIMUM 

NYMIN  =  "  "  MINIMUM  Y-COORDINATE 

NYMAX  =  "  "  MAXIMUM 

Card  2  ( 40 A 1 )  ( IT ITLE( I )  ,  I- I  ,  40 )  ITITLE  =  PLOT 
TITLE  (40  CHARACTERS  OR  LESS) 

CARDS  3  THRU  11  (FREE-FORMAT,  USE  ONLY  AS  MANY  AS 
YOU  NEED  UP  TO  MAXIMUM  OF  9)  VMIN.VMAX, SYMBOL 

VMIN  =  STARTING  VALUE  FOR  THIS  RANGE 
VM AX  -  ENDING  VALUE  FOR  HIS  RANGE 

SYMBOL  -  PLOTTING  SYMBOL  FOR  THIS  RANGE  (MUST  BE  IN  SINGLE 
QUOTES) 

SEDGRAF  is  run  from  PROCLV.  See  Appendix  0  for  instructions. 
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ADDENDUM  I  - 6 :  USER  INSTRUCTIONS  FOR  PROGRAM  WDGPLT 

Purpose 

1.  Program  WDGPLT  produces  plots  of  wet  and  dry  portions  of 
the  finite  element  grid  during  an  RMA-2V  simulation.  The  first 
plot  produced  by  WDGPLT  is  a  plot  of  the  entire  grid  as  produced 
by  program  GFGEN.  For  each  user-selected  time  step,  two  plots 
are  produced — one  of  the  wet  area  and  one  of  the  dry  area.  The 
grid  plots  may  be  rotated  and  scaled  by  the  user. 

Origin  of  the  Program 

2.  WDGPLT  was  written  by  S.  A.  Adamec  of  the  WFS  Hydraulics 
Laboratory. 

Use 

3.  Program  WDGPLT  can  be  accessed  through  PROCLV  in  the 
following  manner: 

8  EG  IN,  WDGPLT,  PROCLV,  ID,UWD,01R1 , 0 ) R 2 , 0 1 WD , R JE 

whe  re 

ID  »  user  name 

I  1  WD  =  filename  for  WDGPLT  card  input  (may  be  null) 

0 1 R 1  =  GFGEN  output  geometry  file 

01R2  =  RMA-2  output  hydrodynamic  file 
01WD  =  output  Metaplot  file  from  WDGPLT 
RJE  =  user  name  of  RJE  printer  for  printed  output 

Input 

4.  Input  to  WDGPLT  consists  of  a  geometry  file  (CFGEN 
output)  on  logical  unit  1,  an  RMA-2V  output  file  on  logical 
unit  2,  and  card  image  run  control  on  logical  unit  b. 

Output 

5.  Output  from  WDGPLT  consists  of  a  GCS/META  Metaplot  file 
and  a  short  printed  output.  The  metafile  can  be  post-processed 
by  DIRECT  into  Calcomp  or  graphics  terminal  plots. 

Instructions  for  Card  Image  Input  Data 

6.  Each  input  data  card  contains  eight  real  input  data 
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fields  of  ten  places  each  (8E10.0).  The  input  title  card  is  80 
characters  wide.  If  any  or  all  of  cards  1  through  7  are  omitted, 
WDGPLT  will  plot  all  of  the  time  steps  on  the  RMA-2V  output  file. 

Card  1  (8E10.0): 

Field  1  AROT  --  grid  rotation  factor  in  degrees 

CCW  from  the  positive  x-axis 

Field  2  SCALE  --  coordinate  scale  factor  to  be  applied 

to  all  coordinates  by  multiplication 

Field  3  TSEL  —  if  nonzero,  plot  only  the  user- 

selected  times  on  cards  2-7 

Cards  2-7  (8E10.0: 

Fields  1-8  TUSE R( J ) , J = 1 , NUTS  —  u s e r - s e 1 e c t ed  times  for 

plotting.  Code  8  values  to  a  card 
up  to  a  maximum  of  48  values  (6 
cards) 

Card  8  ( A80 ) : 

IUTIT  --  an  80-character  plot  title 


CRAPHICS/WDGPI.T 


1-6-2 


AP PL  NO  IX  J: 


OUTPUT  ANALYSIS 


Introduction 


I.  Tin'  purpose  ol:  output  analysis 
imli'li-r  in  interpreting  n  ode  1  results, 
essential  tool  in  output  analysis,  are 
!'li  i  s  appendix  deserilies  those  programs 
analyses  rii.it  are  primarily  n  o  iij;  r  a  pli  i  c  a 
also  produces  ,;r  i,ili  ic  u  1  <!  i  s  p  1  a  y  s . 


[i  r  n>;  r  a  in  s  is  to  assist  t  li  e 
Graphics  displays,  an 
described  in  Appendix  T. 
which  p  r  o  vide  out  p  u  t 
1  ,  t  ho  a;;  b  each  o  I  then 


P  r  op,  r  a  m  s 


Three  programs  are  described  here: 

a.  '’rii;|i';iB  POSTHYI)  analyses  nuput  Iron  K.TA-2V 

and  is  described  in  Addendum  .1-1.  POSTHYI)  will 
also  aecepl  Tii  Id  or  physical  model  data  lor  com¬ 
parison  w  i  t  h  K!i.\-2  V  results. 

h.  Prop, ram  POSTSKD  analyzes  oiiput  Iron  STUDI1.  Il  is 
i!e  scribed  in  Addendum  J-2. 

Pro'.'.ran  ACL  accumulates  results  (rum  one  or  note 
STI'I'h  runs,  combines  t  In  n  as  events  ol  specified 
dtirat  ion,  and  computes  shoal  ini;  and  dredi;inp, 
volumes.  ACK  is  described  in  Addendum  .1-1. 


OUT  PH  I  \NA1.YS1S 


'  >hi..\l>l!M  .1-1:  l  S  : .  k  I  \  1  .<  i  (  l  1  ■ ) .» S  [■'.)('  PilUGi. 


POS  i  il  1  ii 


P  n  r  p  o  s  o 


1.  i’tis  I  M  V  it  is  a  H'licr.il  purpose  postprocessor  tor  KMA-2V. 
I'lie  code  will  produce  various  plots,  comparisons,  and  listings  id 
statistics  Iron  a  run  ol  the  2-1)  hydrodynamic  code.  V.'a  t  e  r-s  u  r  I  a  c  e 
elevations,  velocity  ::ia  i>  n  i  t  ud  e  /  d  i  r  e  c  t  i  on  ,  and  velocity  elili/  I  !  oml 
ii  t  .ii  i  l  u.le  plots  i-  a  ii  ii e  produced.  Comparisons,  both  graphical  and 

I  a  '•  u  I  a  r  ,  can  he  made  between  two  It  M  A  -  2  V  runs  or  an  K1IA-2V  run  and 
data  I  r  o  the  I  i  e  I  !  or  L  r  o  :i  a  physical  model.  A  ranked  correla- 
t  i  on  coetlicient  can  lie  computed  lor  the  comparison,  dan  statis¬ 
tics  include  1 1  a  x  i  m  u  1 1  a  n  l  mini  a  u  pi  values  i  o  r  depths  and  current 

s  pe.  I  . 

<>  r  i  ••  i  n  o  I  P  to,;  r  am 

2.  I’OKTilYO  was  written  by  I'.  P.  bach  of  the  WKS  Hydraulics 
I, a  iio  r  a  t  o  r  y  . 

I'e  t  c  r  i  p  t  i  o  n 

1.  Graphics  Compatibility  System  (CCS)  calls  are  used  for 
plotline,.  Tue  adjustment  to  the  flood  direction  is  performed  by 
a  least  squares  curve  I  it  t  broil}*,  h  the  data.  Tile  correlation 
I'm1 1  I  i  c  i  en  I  c  a  l  c  n  1  a  t  i  a  a  is  peri  nr  mini  by  code  written  by  h.  W . 

aarp  in  Peci  mlier  uni  is  a  v  a  i  I  able  t.  hroup.l:  Lie  WKS 

r'.iiej  necr  i  ni;  (.empnter  e  r  o>;  r  a  n  s  hibrary  (ICPI,  program  number  7G4- 

,■7-1-41  Sc)  . 

Use 


4.  POSTdY!)  is  executed  from  PUOCI.V.  The  Cyber  Control 
I .  l  n  c  n  a e  procedure  call  is  as  follows: 

»!■:::  I  A  ,  PO I'M  Y  !)  ,  I’XDChV  <CK> 


luswr  the  uii’St  inns  that  the  procedure  ask-.. 


I  n  pu  t 


S .  I'  e  virion  i  u  [ui  t  d  a  t  a  t  i  I  a  •• 
d  -  I  -  I  . 


I 


i  r  I  a  h  ! 


a  • 

!  o  r  •>  a  t  , 
card  is 
i  I  •  ■  >i  .  A 
c  1 1  i’i  :as. 
must  he 


r  it  e  run  control  c,i  rils  to  P  tl  s’  'i  u  V  1)  use  .  m  <  <  ,1  i  I  i  c  a  Si'  I 
wile  a  card  idi’iit  i  l  ii-r  in  cu  I  u '  ”i  s  1-1.  la  -  rest  ul  each 
read  in  tr*’i’— lield,  with  commas  or  spaces  s  e  p  a  r  a  f  i  n  a  e  ,  i  c  ' 
II  II  I  |  v  a  I  n  e  I  n  f  a  il  it  e  la  i  s  r  e  p  ri'M’ill  i  i!  by  I  e  C  ll  ’I  .  e  C  II  I  i  Vi 
Character  items  that  contain  r  m  h  i>  il  d  e  d  s  p  a  c  i  s  or  ciuin.m 
e  n  c  |  'is  c  d  w  i  l  ii  a  po  s  t  r  o  ph  i  s  . 


I-  1  -  I 


DhTPhT/ I’  (1  S  T  a  V  |i 


04/85 


lab  If  J-1-] 
Input  II  a  t  a  F  i  1  e  s 


FORTRAN 
Log i cal 
Unit( s  ) 

1  -5 


2  1-1 0 


Input  Pat  a 


RNA-2V  tine-history  data  tiles,  in  chron¬ 
ological  order:  the  file  supplied  on 
Unit  2  should  have  been  "hotstarteil" 
from  the  run  that  p  r  o  ihiccd  the  i  l  e  h  <•  i  i 
supplied  oil  I  n  i  t  I  . 


Data  files  lor  comparison, 
output  from  P.MA-2V,  field 
model  data. 


These  can  he 
data,  or  physical 


40-4  1 


5  0 


G  Ft;  K  N  geometry  files,  the  tile  h  e  i  u  g 
supplied  on  Unit  4 1)  goes  with  the  data  on 
Units  1  -  5 ,  and  the  file  supplied  on  Unit 
4  1  goes  w i t  h  the  data  on  units  21-10.  If 
no  data  are  supplied  on  Unit  41,  and  a 
comparison  is  made  between  two  K'-t  \-2V  runs 
then  t  h  e  p  r  o  g  r  a  n  will  us  e  the  file 
supplied  on  1'uit  40  for  noth  11A-2V  rims. 

Run  control  input  to  POSTHYD,  as 

described  in  the  toll  owing  pages. 


7.  A  summary  of  ROST  I!  YD  run  control  input  is  given  in  Table 
J-l-2.  Figure  J-l-1  illustrates  sample  run  control  input.  De¬ 
tails  of  run  control  input  are  given  following,  Table  J-l-4. 

b  .  Input  file  formats  for  data  to  be  con  pa  r  e  d  with  k  M  A  -  2 
results  are  ;iven  in  Table  .1—1  —  3  (field  data),  .1-1 -4  (oliysieal 
model  tide  data),  and  d -  1  -  5  (physical  model  velocity  data). 

On  tput 

0 .  POST  H Y  D  output  consists  of  printed  tabular  results  and 
plots.  Figure  .1-1-2  shows  a  sample  tabular  output  iron  1’DS  TOY  (;. 
Graphical  output  is  written  to  logical  uni  t  77  and  is  in  standard 
TAIiS  tormat  for  tlRTA  system  plotting.  Sample-  plots  are  shown  in 
Figures  J-l-3  -  .1-1-5. 


OUTPUT /P0STHYD 


1-1-2 


S3?333333338? 


m  r  j> 


WTW7 •  v -  *  TTT*  " 7  V  ’ 


04/85 


p 


h 


■ 


PROGRAM  PQSTHYO. 


UME  A-VEL 
(NOURS)(F?/SEC> 


.00 

-.115 

1.00 

-.341 

2.00 

-  .491 

3.00 

-.269 

4.00 

.  113 

5.00 

.280 

6.00 

.274 

7.00 

.198 

8.00 

.080 

9.00 

-.062 

10.00 

-.186 

11.00 

-.267 

12.00 

-.309 

1  3.00 

-.326 

14.00 

-.337 

15.00 

-.345 

16.00 

-.349 

11.00 

-.345 

18.00 

-.3  33 

19.00 

-.312 

20.00 

-.280 

21.00 

-.237 

22.00 

-.188 

2  >.00 

-.128 

24.00 

-.023 

25.00 

.100 

26.00 

.190 

27.00 

.2  37 

28.00 

.255 

29.00 

.255 

30.00 

.240 

31.00 

.207 

32.00 

.153 

33.00 

.077 

34.00 

-.031 

3S.OO 

-.151 

36.00 

-.243 

37.00 

-.297 

38.00 

-.320 

39.00 

-.3  30 

40.00 

-.335 

41.00 

.337 

42.00 

-.134 

43.00 

-.323 

44.00 

-.300 

45.00 

-.2  66 

46.00 

-.221 

41.00 

-.171 

HfcSH*  VS  MESMl  78K  CFS  01=100.00 
R*A2  AQDE  216 


T- VEL 

MAGNITUDE 

OEPTH 

US  ELEV 

UET/ORY 

(FT/SEC) 

(FT/SEC) 

(FT  > 

(FI) 

STATUS 

-.043 

.123 

5.507 

1 00.507 

MET 

.040 

.344 

5.391 

100.391 

MET 

-  .005 

.491 

5.185 

100.185 

UE  T 

-.061 

.276 

5.152 

100.152 

UET 

.  166 

.201 

5.411 

100.411 

UE  T 

.  368 

.463 

5.714 

100.714 

UET 

.329 

.428 

5.884 

100.884 

UET 

.166 

.258 

5.942 

100.942 

UE  T 

-.018 

.082 

5.929 

100.929 

UE  T 

-.158 

.170 

5.8  54 

100.854 

UE  T 

-.233 

.298 

5.733 

100.733 

UE  T 

-  .290 

.394 

5.582 

100.582 

Wf  T 

-.155 

.470 

5.408 

100.4U8 

UET 

-.411 

.525 

5.225 

100.225 

UE  T 

-.449 

.562 

5.040 

100.040 

UE  T 

-.470 

.583 

4.855 

99.855 

UE  T 

-.477 

.591 

4.675 

99.675 

UET 

-  .469 

.583 

4.510 

99.510 

MET 

-.444 

.555 

4.372 

99.372 

UET 

-.400 

.507 

4.269 

99.269 

U6T 

-.339 

.439 

4.212 

99.212 

UET 

-.260 

.352 

4.210 

99.210 

UET 

-.160 

.247 

4.269 

99.269 

UET 

-.029 

.131 

4.386 

99.386 

UET 

.118 

.120 

4.546 

99.546 

UET 

.234 

.254 

4.735 

99.735 

UET 

.  303 

.357 

4.941 

99.941 

MET 

.339 

.414 

5.156 

100.156 

MET 

.354 

.436 

5.366 

100.366 

UET 

.  341 

.431 

5.555 

100.555 

UET 

.316 

.  397 

5.714 

100.714 

MET 

.262 

.3  34 

5.830 

100.830 

UET 

.183 

.239 

5.896 

100.896 

WE  T 

.081 

.112 

5.901 

100.901 

MET 

-.046 

.055 

5.845 

100.845 

UET 

-  .166 

.224 

5.738 

100.738 

WET 

-  .261 

.357 

5.593 

100.593 

UET 

.331 

.449 

5.422 

100.422 

MET 

-  .399 

.512 

5.  >35 

100.235 

MET 

-  .443 

.553 

5.045 

100.045 

UE  T 

-  .468 

.575 

4.857 

99.857 

UET 

-.475 

.583 

4.674 

99.674 

UET 

-.467 

.574 

4.508 

99.508 

UET 

-.440 

.546 

4.367 

99.367 

UET 

-  .  396 

.497 

4.264 

99.264 

UET 

-.333 

.426 

4.208 

99.208 

MET 

-  .254 

.336 

4.208 

99.208 

UET 

-.154 

.230 

4.268 

99.268 

UET 

TIME  HISTORY  TABLE 
RMA2  NODE  216 

MS  El  E  V 
(FT  ) 


100.013 
1 00. 02* 
100.090 
100. 2*8 
100.475 
100.701 
100.868 
100. 951 
100.942 
100.857 
100.727 
100. 572 
1 00.402 
100.223 
1 00.039 
99.853 
99.673 
99.508 

99.368 

99.265 

99.207 
99.206 

99.266 
99.386 
99.547 
99.737 
99.947 

100.163 
100.371 
100.560 
100.719 
100.837 
100.902 
100.905 
1 00.846 
100.737 
100.591 
100.420 
100.237 
100.049 
99.861 
99.678 
99.510 

99.369 
99.265 

99.208 
99.208 
99.268 


b 


I-  i  .  '  .  r 


oi  TPr  r/ pos  riiYn 


PROGRAM  POSTMTD.... 


HESH*  VS  NESH1  78*  CES  Ci*100.00 
RMA2  RODE  at 


TIME  MISTORT  I  ABLE 
RMA2  NUDE  216 


TINE  *-VEl 

( HOUR  S)(Ff/SIC) 


V-VEL  HAGN I TUOE 
CFT/SEC)  (ET/SEC) 


MS  ElEV  VET/ORY 
(FT)  STATUS 

100. SOT  WET 

100.391  VET 

100.185  VET 

100.152  VET 

100.411  VET 

100.714  VET 

100.884  VET 

100.942  VET 

100.929  VET 

100.854  VET 

100.733  VET 

100.582  VET 

100.409  VET 

100.225  VET 

100.040  VET 

99.855  MET 

99.675  MET 

99.510  MET 

99.372  MET 

99.269  VET 

99.212  MET 

99.210  MET 

99.269  MET 

99.386  MET 

99.546  MET 

99.735  MET 

99.941  MET 

100.156  MET 

100.366  MET 

100.555  MET 

100.714  MET 

100.830  MET 

100.896  MET 

100.901  MET 

100.845  MET 

100.738  MET 

100.593  MET 

100.422  MET 

100.235  MET 

100.045  MET 

99.857  MET 

99.674  MET 

99.508  MET 

99.367  MET 

99.264  MET 

99.208  MET 

99.208  MET 

99.268  MET 


VEL 

Y-VEL 

MAGNITUDE 

SEC) 

(ET/SEC) 

CFT/SEC) 

.112 

-.069 

-.132 

.105 

-  .048 

-.116 

.060 

.060 

.085 

.059 

.241 

.249 

.188 

.361 

.40  7 

.252 

.356 

.436 

.237 

.259 

.352 

.156 

.120 

.  197 

.024 

-.041 

-.04  7 

.117 

-.168 

-  .204 

.208 

-.237 

-.315 

.251 

-.282 

-.377 

.2  71 

-.322 

-.421 

.288 

-.356 

-.458 

.  306 

-.380 

-.487 

.  321 

-.391 

-.506 

.  329 

-.391 

-.511 

.  328 

-.378 

-  .501 

.316 

-.351 

-.472 

.293 

-.307 

-.424 

.258 

-.245 

-.355 

.210 

-.162 

-  .265 

.150 

-.053 

-.159 

.063 

.083 

.  104 

.048 

.192 

.198 

.  1  38 

.253 

.288 

.185 

.289 

.34  3 

.206 

.309 

.372 

.213 

.314 

.380 

.209 

.301 

.36  7 

.188 

.268 

.328 

-149 

.214 

.261 

.088 

.138 

.164 

.003 

.036 

.036 

.101 

-.081 

-.130 

.189 

-.179 

-.260 

.244 

-.251 

-.350 

.275 

-.307 

-.412 

.293 

-.350 

-.456 

309 

-.379 

-.489 

322 

.395 

-.509 

.330 

-.396 

-.516 

329 

-.  383 

-  .50  5 

.318 

-.354 

-.475 

.294 

-.308 

-.426 

.258 

-.244 

-.355 

.209 

-.162 

-.265 

.149 

-.054 

-.158 

I’OSTHYi)  sample  out  pit  L  (font  inuod) 


r  AD-A162  19a USER'S  MANUAL  FOR  THE  GENERALIZED  COMPUTER  PROGRAM  6/g 

SVSTEM  OPEN-CHANNEL  FL  <U>  ARMS'  ENGINEER  NATERUAVS 
EXPERIMENT  STATION  VICKSBURG  M5  HVDRA 
UNCLASSIFIED  U  A  THOMAS  ET  AL  AUG  85  UE5/'IR/HL-85-’l  F/G  12/2  NL 


r* 1 


,‘Jnhrnn 


-';i  1  m  run  t  itli- 

J-  1 

-1  J 

Lin.i'iid  no  tat  ions  tor  plotting 

J  -  1 

-  1  4 

I’l  i)  L  axis  limits 

J-l 

-  1  S 

Plot  curve  synbo 1  control 

.1-1 

-  1  b 

i’iot  curve  line  control 

.1-1 

-  1  7 

Control  of  source  of  comparison 

J-l 

-  1  H 

Pint  lime -history  at  individual 
nod  e 

J-l 

-19 

Produce  profile  plot  a  lout;  se¬ 
ll  c  t  oil  nod e  s 

J-l 

-2  1 

Produce  continuity  check  alonj, 
so  1  i.>  c  to  d  no  lies 

.1-1 

-22 

Co  ii  t  in  u  a  Lion  card  used  by  t  h  e 

P  •’  a  nd  c  o  m  n  a  nils 

J  -  1 

T  a  b  1  e  .1-1-3 


He  cord 

N  u  n  b  e  r 

Co  1 umn  s 

Field 

To  r  n,i  t 

Data  Input  Format* 

De script  i  o  n 

1 

1  -80 

A 

A  title  describing  tbe  station 
t  y  p  of  data. 

2 

i  -  h 

A 

.3  c  b  a  r  a  c  t  e  r  s  i  d  e  n  t  i  i  y  i  a  ;  t  a  «■ 
station. 

24-25 

I 

Starting  nontli  number  (1-12). 

2D-27 

T 

Startin'  .lay  (1-31). 

2  8  -  2  P 

I 

Start  in y ear  (1-63). 

32-33 

I 

Starting  b  o  u  r  (  1  -  2  ■.  )  . 

34-35 

1 

Start!  n  >;  m  i  mi  L  e  (  o  -  5  s  )  . 

53-57 

1 

Tire  increment,  in  rii  antes. 

84-63 

I 

Number  of  data  points. 

70-77 

,\ 

A  Cb  a  i  a  c  t  t  r  i  -1  e  n  t  i  !  i  ■■  r  lor  t  y  pc 
il  a  t  a  . 

=  "  T I  UK K  1 1  "  tor  tides. 

= "  X-VIIL  "  for  the  x- voice 

c  o  n  p  o  n  e  n  t  s  . 

=  "  V  -  V  K  1,  "  l  o  r  t  li  e  y-ve  1  o  c 

C oil'  poll e  11  L  s  . 

3  + 

1  1  -K0 

1  U'  7  . 

O  lata  points,  )  i  pet  line  until 

d  a  t  ;i  are  input. 

,.o  t  :  files  may  contain  m  n  I  t.  i  p  I  i*  s  t  a 1  i  o  n  a  an'  ■  ■  1  ' 

field  t  v  pc  iiK!]).ir  i  sum  file  tel  lows  ,i  •  n  r  in  a  t  I  1 1  i  f  \-  ■■  ■  1  e  "  .  • 

IS.  i’.  Donnell  [or  tile  Atcbnfalaya  I’.ay  ll.tl  t.i  e  rn»l  1  study. 


OUTPUT /POSTHYD 


.1-1-1 


04 /d  5 


Tan  Lo  J  -  1  —  /. 

Physical  Model  Tidal  Input  Hata  format* 


!■'  e e  o  r  tl 
X u r ho  r 


I 


t  +  •• 


+  * 


Co  I  ui'in  s 
1-7 

I  -  7 
S  -  1  i 
1  -7 

■i  -  1  1 

1-7 
:-i  -  I  4 


t-'o  r  ma  t 
I 
4 

I 

I 

l 

I 

1 


_ Of*  s  c  r  i  p  t  i  o n 

Line  nunber. 

Characters  i  :l  cn  t  i  >  yin;  the  data 
f  i  1  e  . 

Line  n  union  r  . 

Number  of  stations  on  this  file. 
Line  n  uri  he  r  . 

Station  identit  i  it  lor  the 
1  ol  low  in,;  tidal  data  set. 

Line  n  un  be r  . 

Value  of  water-surface  elevation. 


,ute-i:  I.  Insert  a  record  type  4  for  each  data  point  lor  i 

particular  station.  Use  a  record  type  3  to  start  oft 
the  data  lor  each  ol  the  stations  counted  in  record 
t  y  ■>  e  2  . 

2.  This  option  itas  not  been  implemented  yet. 


.1-1-11 


Oil  T  P  ll  T  /  POST  it  Y  ! ' 


E 


Table  J-l-5 

Physical  Model  Velocity  Input  Data  For  pi  at 


Record 
e 


Columns  Format 


Poser i pL ion 


1 

1-7 

1 

Line  n  un  be  r  . 

8-80 

A 

TJentilyin>;  title  lor  this  tile. 

0 

1-7 

l 

Line  n umbo r  . 

8  -  1  ii 

1 

Number  of  stations  on  this  lili. 

3  +  * 

1-7 

1 

Line  n un  be r  . 

P  -  1  1 

1 

Station  identifier. 

12-14 

I 

Number  of  depths  fur  w  Ii  i  c  h  dat 
were  taken  at  this  station. 

15-18 

A 

Meter  nunber  taking  data. 

1  0-25 

F 

Total  depth  at  this  station. 

2  4-32 

F 

Depth  t'or  the  bottom  read  lap,  . 

3  3-30 

F 

Depth  for  the  nidd.pth  mailin'.. 

4  u  -  4  7 

K 

Depth  for  the  surface  read  inn. 

4  8-54 

F 

X-coordinate  for  station. 

5  7-44 

F 

Y-co ordinate  tor  station. 

4  +  * 

1-7 

1 

Line  n umbo r  . 

8-14 

F 

Velocity  magnitude,  in  t  t  /  s  e  c  . 

1  5  -  1  f* 

I 

Vc  1  o  c  i  t  y  d  i  r  e  c  t  i  o  n  ,  i  n  d  i  i  e  s 

clockwise  iron  north  i  i  v  i  d e  d 
h  y  in. 

7  3-70 

A 

Depth  for  data,  equals  "  !,  Hi  fn 

"'ll  0  D  K  PI  ,  "  or  "St  i-.FACr."  . 

K  No  t  e s  : 

1  . 

1  n  pu  t 
card 

on  re 

a  r  e 

t  y  |><! 
cord 

cord  type  4  for  inch  time-step.  Insert  a 

3  before  the  data  for  inch  station  counted 
type  2. 

')  t 

T'i  i  s 

opti  o  11 

has  not  been  implemented  vet. 

OURPUT/POSTHYD 

.J 

-  1 

-  1  ’ 
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T2  CARD:  Legend  Notation s  f  o  r  Plot  t im; 


Field 


Variable 


Description 


c°l-  I-  1C1  Card  keyword  =  T2. 

Col.  2 


Lh  G  (  1  )  Up  to  8  characters  o  t  i  n  t  o  r  m  a  t  i  o  n  t  o 

be  u  s  e  dt  o  identity  t  h  e  h.is  e  curve 
in  the  Legend  tie)  I.  It  this  field 
is  null,  a  blank  is  assumed. 

l.KG(2)  Identifier  for  tlie  second  curve.  If 
null  or  not  supplied,  a  blank  is 
assumed  . 


Note:  It  the  T2  card  is  omitted,  blanks  are  assumed  lor  l.rC(l) 
and  LKC( 2 ) 


OUTPUT/POSTHYD 


I  -  I  -  I  /, 


PL  CAKl):  Plot  Axis  Limit 


Kiel  <1 

U)  1  .  1  - 

Co  l  .  2 


Variable 


Description 


Card  keyword  =  PL. 


Mini  mini  value  for  t  lie  X-axis  (time), 
in  model  hours. 

Maximum  value  for  tile  X-axis. 

Note:  If  both  XII  IN  and  XMAX  are  null, 
the  X-axis  will  be  self  scaled. 

Minimum  value  for  the  Y-axis  (data), 
in  w  b  a  t  e  v  e  r  u  n  i  L  s  the  data  h  e  i  n  j» 
plotted  are  in. 

Maximum  value  for  the  Y-axis. 

Note:  If  both  YM IN  and  YMAX  are  null 

or  nu  tsuppl  i od , t  ho  Y-axis  will  be 

ss e i 1  seal e d  . 


into:  II  the  PL  card  is  not  supplied,  both  the  X-  and  Y-axos  will 
ii'  sell-scaled. 


-I  —  I  —  1  S 


IMITPP  I  /  P(IS  I  h  ill 


E 


Kiel  ft 

Co  1  .  ] 

Col.  2 


2 


Nolo:  I 
a  iid  -  1 


SC  CARD:  Plot  Curve  S  y  in  bo  1  Control 


Variable 


IC1 

i  s  y  (  l  ) 


ISYM(  2) 


lie  s  c  r  i  p  t  i  o  n 


(‘a  r  (I  k  o  y  wo  r  (1  =  SC  . 


S  y  n  bolt  y  p  e  t  o  be  iisci!  to  1  o  c  a  t 


each  data  point  on  t  tie  base  curve. 

The  v.i 

lid  s  > 

mind  types  are  as  follows 

-1  = 

plot 

no  s  yn b o 1 s 

('  = 

plot 

square  symbols 

1  = 

plot 

o  c  t  a  '.pi  n  s 

2  = 

pi  o  t 

t  r  i  a  n  ,<  1  e  s 

5  = 

plot 

crosses 

4  - 

e  1  o  t 

X  '  s 

5  = 

p  1  o  t 

d  i  a  mind  s 

1  1  = 

plot 

asterisks 

1  4  = 

plot 

5  -  p  o  i  n  t  e  d  surs 

If  ISYM(l)is 

n  u  1  1  ,  a  v  a  1  ii  e  o  f  ;•  i  s 

as  k  une<l  . 


Symbol  type  to  be  nsid  to  1  nr  ,i  t  i  >  j  (  |, 
lot  a  point  on  t  li  e  c  o  in  p  arts  o  no  nrvr, 
T  f  T  S  Y :  1  (  2  )  is  null  or  not  supplied, 
a  value  ot  -1  is  assumed. 


I  the  SC  card  is  not  supplied,  values  ot  0  for  J  y  m  (  j  ) 
tor  IS  YS(2)  .ire  assum'd. 


OUTPUT/POSTHYD 


I  -  1  -  1  f, 


o',  /V  5 


I.C  CARD:  I’lol  Curve  Line  Control 


Kiel  d 


Col.  1 
(a  >  1  .  i 


Variable 


1  C  l 


l :  i  S  H (  1  )* 


I  I)  S  i  l  (  2  )  ’ 


De  sc  r l p  t ion 


Card  keyword  =  I.C. 


Line  type  control  tor  t  lie  basecurve. 

If  IDSII(l)  is  null,  a  value  of  0 
(meaning  plot  a  solid  line)  is  assumed 


Line  type  control  for  the  comparison 
curve.  I  l  1  D  S  il  (  2  )  is  null  or  not 
supplied  a  value  ot  5b  (the  CCS 
default  tor  a  dasbed  line)  is  assum'd. 


Note:  It  tin'  LC  card  is  not  supplied,  values  of  0  tor  JI)SH(l)  and 

5  b  tor  I’.)SII(?)  .ire  assumed. 

*  1.  i  in'  control  uses  tne  CCS  dash  index  codes.  See  The  Graphics 
Com  pa  t  i  bi  l  i  t  y  S  y  s  t  c  ia  (CCS),  I'roiiranncr's  Reference  Manu_a_l_,  Autu- 
nTa  t  ■■■  d  Tec  b  n  o  1  oi;  y  CT^  n  t  e  r  ,  U.  S.  Army  I.  n  ••  i  a  e  e  r  Waterways  experiment 
Station,  Vicksbiir;;,  Miss.,  tor  an  explanation. 


Ml 


CS  CARD:  Control  of  Source  ol  Comparison 


Field 

Col.  1  - 
Col.  2 


2 


3 


Variable 


De  s  c  r  i  |>  t  ion 


IC1  Card  keyword  =-  CS  . 


C  DATA 


DATUM 


NK  AN 


=  FIKLD  it  data  tor  tin-  c  <•  r:  p  a  r  i  s  o  n  are 
t  o  be  read  f  rom  a  t  i  <•  1  I  data  I  i  1  (■  , 

=  1'  U  Y  S  T  C  A  I.  it  data  tor  t  ti  «•  eon  ;•••  risen 

are  to  be  read  iron  a  uiysicil  no 
data  file. 


=  R  M A  2  V  it  two 

R  M  A- 

2  V  runs  :  i 

V  <> 

compared . 

=  NO  if  no  com pa  r i 

i  sons 

a  re  to  he  n 

• 

Value  to  be  subtracted 

Iron  i'  M  A  -  .!  1 

;  V.;lf 

surface  elevations  betore  ploltin,, 
in  feet. 

1  f  M  KAN  is  not  equal  l  o  N  i  ■  ,  the 
comparison  curve  will  be  1 o  r  c  e  e  to  b  a 
the  sane  mean  as  the  base  curve.  It  "  r. 
is  not  supplied  or  null,  a  value  ol 
is  assumed. 


Note:  If  the  CS  card  Is  not  supplied,  no  comparison  curves  will 
be  drawn. 


OUTPUT/ POSTHYD 


.1—1  —  I  s 


i’N  c  a  i;  n : 


I'Iol  rime -l.i  Story  .it  Individual  Node 


iu  1 .!  Va  r  i  able 

Co  1.1  -  f  (.  I 

Col.  2 

1 

2  k  !  (  1  ,  l ) 


1 


i  re  r 


Description 


Card  keyword  =  Pfl. 


Node  Iron  KMA-2V  base  li la  to  bo  plotted. 

Starting  time  for  read  in-;  rl".  A-2Y  base 
file.  If  It  T  (  1  ,  I  )  is  null,  the  plot  will 
bop,  in  at  the  first  timestep  on  Hit  file. 

=  h'S  to  plot  water  surface  elevations. 

=  V  M  I)  to  plot  velocity  m  a  n  i  t  u  2  e  a  u  d 
.!  i  r.ict  ion  vectors. 

=  K  K  M  to  plot  ebb  - flood  n  a n  i  t  u  d  c 

curves.  If  1  V  !,T  is  null,  no  plots  are 

produced  . 


*  The  followin'  field  is  supplied  only  it  CDATA  (see  CS  card)  is 
K  M  A  2  ** 

L  fODK(2)  ,o.:!e  fron  KMA-2V  cuwp.ir  i  sun  file  to  be 

plotted.  If  H0I)K(2)  is  null  or  not 
Stippl  i  ed  ,  NOI!.;(  2  )  =NODK(  1  )  . 

;c  *  '[■  he  fall  o  w  i  n  ;>  field  is  suppi  i  m!  only  if  CDATA  i  s  f  I  h  I.  D  o  r 

PHYSICAL  ** 


I  ST  A 


Tice  st  a  t  ion  i  <1  rut  i  finr  for  the  compari¬ 
son  curve,  10  characters  in  lei.tli 


**  Tin  rol  lowin'’,  fie’!  is  suppi  i  ed  only  if  1  1M.T  is  VMll 


c,  p,  i  :>  An,',  L  ■  o  l  rot  a  Linn  o  t  v  e  c  L  o  r  s  o  n  plot, 

connLerclocf.wi.se  from  the  Liao  axis,  in 
...roes,  I  i  Dill  is  null  or  not  supplf’d, 

a  vi  i  iil'  r>  I  /ere  f  s  a  s  u  n  e  rf  ,  This  ,1  lews 

v  e  c  t  o  r  s  t  !>  a  l  li  a  v  a  n  ■■  n  >;  1  •  <>  l  b  or  11 

d  e  ;  r  e  es  to  l<e  shown  more  clearly. 

**  par  lol  lowin  ;  lield  is  supplied  only  it  IFI.T  is  K!'!1 

r,  <  it  •>  i  root  ion  ol  i  1  nor!  ,  in  do-;  roes  clockwise 

l  ran  tile  north,  li  l  ‘  1  a  is  n  e ; ,  a  t  i  V  r‘  , 

the  a  1)  s  o  l  u  t  e  V  a  1  u  e  o  I  DIP  will  b  1 

adjusted  b.ismi  n  n  a  1  e  a  s  l  s  r|  u  a  r  e  s 

tit  to  the  d  a  t  a  he  i  "  ,  ;>  1  o  t  t  e  C  . 

I  l  I  |  It  is  null  o  r  n  <>  t  s  u  p  p  1  i  e  «'■  ,a  va  1  u  o 

o  I  / 1  •  r  o  is  assumed. 

:<  *  field  b  is  not  suppi  ir  .1  nor  miller!  it  li’l.'l  is  "" 


•J  -  1  -  I  ° 


opt pi",7 ins  ri,vn 
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p  14  Card:  Plot  Time  !listorv  at  Individual  ho  de  (  cuntin  u  e  il  ) 


*  *  The  following  two  fields  are  supplied  only  if  (III  AT  A  is  FIT  |,p  a* 

b  Sill 1 ;"  (  1  )  Starting  date  at  which  to  read  1  i  e  1  d 

data,  in  HMDLYY  format. 

7  S  T I M  K  (  2 )  Startin;;  tine  at  w  ti  i  c  h  to  read  field 

data,  in  PHMH  format. 

*  *  The  following  field  is  supplied  only  if  CHAT  A  is  P  ti  Y  5  >  d  A  I.  or 
Rll  A l  ** 

b  P.  T  (2,1)  Starting;  tine  at  which  to  read  physical 

or  K  M  A  -  2  V  d  a  t  a  .  I  f  l\  T  (  2  ,  1  )  is  null  or  not 
suppl  ied  ,  RT ( 2  ,  1 )  =  KT(  1,1). 

**  The  following  field  is  supplied  only  if  CDATA  is  PHYSICAL  and 
IPLT  is  T KM  or  V  ** 


V  T  Y  P  E  =  SURFACE  to  plot  surface  velocities. 

=  MI  DDE  PTH  to  plot  middepth  velosities. 

=  HOTTO.'l  to  plot  bottom  volotilins. 

=  AY K HACK  to  plot  average  velocities. 

I f  V T  Y P  E  is  null  or  not  supplied,  a 
value  of  AVERAGE  is  assumed. 


=  -i 


OUTPUT/POSTHYD 


d  -  I  -  ■ 


Col.  1  - 
Col.  2 

1 


2  + 


Variable  _ Description  _ 

10  1  Card  keyword  =  PP. 

RT ( 1  ,  I  )  Time  at  which  to  read  the  RMA-2V  base 
file  for  the  profile  plot. 

LINKC  Nodes  where  water-surface  elocutions 

are  to  be  computed, as  many  as  an  80- 
column  card  can  hold.  Continue  on  the 
&  card  . 


J  -  1  -  2  I 


OUTPUT/ P 0  ST  H  Y 0 


N 


CC  CARD:  Produce  Continuity  Check  Along  Selected  Nodes 


Field  Variable  _ Description 


Col.  1-  1C1  Card  keyword  =  CC. 

Col.  2 


1  R  T ( 1  , 1 )  Time  at  which  to  read  the  K  M  A -  2  V  base 

file  for  the  continuity  check. 

2+  hi  NFC  Nodes  defining  the  continuity  cross 

section.  The  nodes  must  connect  w  i  t  1 1 
each  other,  and  both  mid— side  and  corner 
nodes  must  he  specified.  As  many  nodes 
as  an  8') -column  card  can  hold  can  he 
specified  on  this  card.  Continue  with 
more  nodes  on  the  f,  card. 


W-WV-W  ‘ 


OUTPUT /POSTHYD 


J  -  1  -  2  2 


ADDENDUM  J-2: 


UROGRAM  POSTS  E D 


Purpose 


1.  POSTSED  produces  an  analysis  of  a  STUDII  output  tile  and 
prints  pertinent  deposition,  erosion,  and  concentration  statis¬ 
tics  tor  each  time-step  on  the  file.  The  user  may  optionally 
select  certain  nodes  (by  element  or  node)  for  which  the  con cen¬ 
tra  Lion/bed  change  values  are  to  be  printed  at  each  time -step. 
Modal  deposition  and/or  concentration  data  can  be  plotted  on  a 
line  printer  or  any  GCS / M ETA-s u p po r t ed  graphics  device. 


Use 


2.  POSTSED  is  accessed  through  PROCLV  by  the  command: 
IS  EG  IN  ,  POSTSED  ,  PR0C1.V  ,  i  i  1  e  1  ,  f  i  1  e  2  ,  f  i  1  e  3  .name  ,  pr  i 


wh  e  r  e 


1  i  l  e  1 

=  name 

ot 

the 

card  image  run  control 

i  n  jhi  t  l  il 

£  i  l  e  2 

=  n  a  m  o 

o  f 

t  he 

STD  D  H  output 

file 

f  i  l  e  3 

=  name 

o  l 

t  he 

GCS/ MET  A  plot 

file 

(  i  t 

o  e  e  d  e  d  ) 

name 

=  your 

last  name 

pr  i 

-  o  p  t  i 

o  n  a  1 

job 

)>  r  i  o  r  i  t  y  (  d  e 

1  a  ult 

i  s 

P  3  ) 

I  n  [i  u  t  data 

3.  Input  data  consist  of  the  STUDIi  output  file  and  a  card 
image  run  control  file.  The  card  image  file?  uses  a  modified  H  E  G 
input  format,  with  the  first  three  columns  of  each  card  reserved 
for  card-identifiers.  The  remainder  of  the  card  is  free  field, 
with  comm  a  s  separating  each  numeric  t  i e  Id.  Do  n  o  t  exceed  IS 
numeric  fields  on  any  input  card.  Input  cards  ri  a  y  appear  in  any 
order  or  may  lie  omitted  from  the  card  image  input  I  ile. 

4.  Table  J-2-1  lists  the  run  control  input  card  images 
needi-d  to  run  the  program.  A  detailed  description  o  t  each  card 
i  1.1,1  ,,e  follows  the  table. 


On  t  [in  t 

5.  Out  [mt  consists  of  printed  results  and  plot  files. 
Example  outputs  are  shown  in  figures  .1-7-1  -  ,1-2-7.  At  the  e.i 

time-step,  the  number  of  nodes  experiencing  il  e  pos  i  t  i  on  /  e  ros  i  on 
are  listed  and  a  statistical  breakdown  of  the  bed  changes  is 


.1-2-1 


OUT  PUT/ POSTSED 


04/85 


printed.  Optionally,  the  same  breakdown  nay  be  applied  to  con¬ 
centration  data.  Selective  print  ini;  of  nodal  concont  r.it  i  nn/hcd 


chan  jo  values  is  also 

avail ab 1 e  a  t  each  t ino- 

•s  t  e  p. 

6  • 

K  i  1 

e s  contain 

iai;  printer  plots  or  ft; 

S/  li  XT  a  plot  s  ,i  r  e 

written 

tor 

bed  cliar.;;o 

and/or  concentration  a 

s  directed  by  t  b  e 

1 

card  in.i 

:5 v  i 

n  pti  t  file. 

Examples  are  shown  in 

v  i  .j  ii  res  .l-p -4  - 

■. 

J-2-7. 

Plotting  o  1  t  hi 

o  i  i  1  e s  is  a c  c o in  p  1  i  s  b e d 

by  tile  META  syste 

(see  A  p p 

e  n  <■  i 

x  1  )  . 

i 


i 

i 


i 


i 


! 


OUTPUT/POSTSEI) 


0  !,  /  8  S 


number  of  ♦  concentration  nodes 

MAXIMUM  CONCENTRATION  AT  NOOE 
MINIMUM  CONCENTRATION  AT  NOOE 


TIME  *  90000. OOC  2S.00)  *«» 

•  POSITIVE  CONCENTRATIONS* 


PERCENTAGE 


.  69  02  680  9  E-  09 

. 303709416*02 

98.62 

.  30  37  09416  *02 

•607418B2E*02 

.55 

>6014  18826  *02 

.911128246*02 

.09 

•91 11 2824E*02 

.121483766*03 

.28 

■121483766*03 

. 151854716*03 

-1  8 

151854716*03 

.182225656*03 

.18 

.182225656*03 

. 212596596*03 

.00 

21259659E*03 

.242967536*03 

.00 

242967536*03 

.273338476*03 

.00 

2  7  33  384  7E*  03 

.303709416*03 

.00 

303709416*03 

. 334080356*03 

.00 

334080356*03 

. 364451296*03 

.00 

364451296*03 

.394822246*03 

.00 

394822246*03 

.425193186*03 

.00 

42$1931BE*03 

.455564126*03 

.09 

100.00 

NUMBER  OF  -  CONCENTRATION  NOOES  825 
MAXIMUM  CONCENTRATION  AT  NOOE  1*78 
MINIMUM  CONCENTRATION  AT  NOOE  17S5 


•  NEGATIVE  CONCENTRATIONS* 


PERCENTAGE 


•  87887227E-10 

-.115389006*02 

98.30 

1 1 538900  E ♦ 02 

-. 230778006*02 

.73 

230778006*02 

-.  34  61 66  99  E ♦ 0  2 

.12 

346166996*02 

-.46155599E*02 

.12 

461555996*02 

-.576944996*02 

.00 

576944996*02 

-.692333996*02 

.12 

692333996*02 

-.807722996*02 

.12 

807722996*02 

-.923111996*02 

•  12 

9231 1199E*02 

-. 103850106*03 

.00 

10  3850106*03 

-.115389006*03 

.00 

1 1 538900  E*  03 

-.126927906*03 

•  24 

126927906*03 

-. 138466806*03 

.00 

138466806*03 

-.150005706*03 

.00 

150005706*03 

-.161544606*03 

.00 

161544606*03 

-.173083506*03 

.12 

100.00 

NUMBER  OF  NOOES  V/  I£RO  CONCENTRATION* 


,lirt.  j_2-|.  x  -i  m  [> !  *'  st.iListii.il  output  I  roll  IM  i  S  i  S  i .  1 ' 


.1-2-3 


OUT I’l'T/  I’OSTSKI) 


2.d8E*00* 


l. S2fc*00* 


2. ise*oo* 


l.M£*00r 


i .426*00* 


I . 06  t  *0  0  • 


6.92E-01* 


-KJ1I-0?* . • . . ,» . . • . ••••• . . . . ,* . 

1.39C»0J  01  1.7Si*04  2.$6E*04  3.361*04  4.t7€»04  4.97E*04  5.78E*04  6-58E*04  7.39E*04  B.19E*0*  9.00E*04 
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0 CT PV T/ POSTSKD 


S - S9C-0 1 » 


.* . • . • 


t . J9E  *0 3  1.44f»;j  l.l$E«04  J.56l*04  ).)6E*04  4.17£*04  4.9JE*04  S.f8E«04  6.S8E»04  7.39E*04  I.19E’04  9.00E»Q4 


1 1'  r  ,1  -  .  •  v  .<  r.  j  !  ,>  p  r  i  11  r  (.•  r  plot  <>  it  t  p  u  t  of  h  o  <1  c  h  ;i  n  l*  h  i  s  t  o  r  y 


output/  postsk:) 


04/85 


***  TIME  =  90000. 00(  25.00)  #9* 

♦DEPOSITION* 

NUMBER  OF  DEPOSITION  NODES  1*11  • 

MAXIMUM  DEPOSITION  AT  NODE  2023 
MINIMUM  CE POSITION  AT  NODE  1920 


MIN 

MAX 

PERCENTAGE 

10148092E-05 

. 9068*925E-01 

97.38 

9068*925E-01 

. 181368636*00 

.92 

181368836400 

. 272052746400 

.28 

2720527*E*00 

. 362736656400 

.  5  0 

.  36  2  7  366  5  £♦ 00 

.453420566400 

.43 

453420566400 

. 544104476400 

.00 

544104476400 

. 63*78838E*00 

.  1  <♦ 

63*788388*00 

. 725472296400 

.0  7 

725*72298*00 

. 816156206400 

.00 

8161 56206400 

. 906840116400 

.  1  4 

906840116400 

. 997524026400 

.00 

99  7524026400 

.  108820796401 

.00 

10882079E«01 

. 1 1 7889186401 

.0  7 

117889186401 

.126957586401 

.00 

126957586401 

. 136025976401 

.07 

100.00 

**«  NO  EROSION  *** 
HUMBER  OF  NODES  N/  NO  ACTIVITY  9*9 


Figure  J-2-4.  Example  printout  showing  erosion  and 
deposition  numerical  distribution 
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BED  CHANGE 


0  4/p.  3 


Table  J-2-1 

l1 0  STS  K  U  Run  Control  Card  Images 


C  a  r  d 

Content 

P  a  t>  e 

r  1 

Title  card 

J-2-1  (1 

DT 

Statist! c  a  1  data  type 

J-2-1  5 

PS 

Selective  print 

J  -  2  -  1  1 

r  <  i 

S  elective  plot 

J  -  2  -  1  2 

AX 

Plot  a  x  e  s  limits 

J-2-1  3 

CT 

Graphics  type 

J  -  2  -  1  4 

T 1  CARD 

Field 

Col  .  1  - 

Co  1  .  1 

1 


Main  Run  Title 


Opt i o n  a  1 


Variable 


l)  e  s  criptiun 


ICC 


Oa  rd  key  wo  r  <1  =  T  1 


IT  IT1J-.  SO-c  h  a  r  a  c  t  e  r  user  title. 

POST  S  K 1)  does  not  use  the 
title.  It  is  user  i  d  e  n t  i  f  i 
cation  o  t  the  I  i  1  e  . 


OUTPUT/POSTSED 


i  -  :•*  -  i 


i’S  CAM!  Selective  Print  by  nixie  or  Element 


04/K5 

Optional 


i"  1  .  I  - 

.;>»  1  .  2 

Co  i  .  i 


V  i  r  i  n  h  1 1 
I  CO 


_ Description 

Card  keyword  =  PS 


Can  be  blank  or  " N . "  If  blank, 
the  following  numeric  fields 
are  assumed  to  be  element  num¬ 
bers  whose  nodes  are  used  in 
selective  print. 

If  i-J  ,  the  following  numeric 
fields  are  assumed  to  be  node 
numbers . 


1  -  1  i 

I  W  A  is  T  L 

Nod 

e  o  r 

e  1  e 

men  t 

n  on  be 

rs  . 

NOT K : 

I  f 

t  he* 

PS  cards  are  < 

a  ri  i  1 1  e  d  , 

there 

w  i 

1  1  be 

no  s 

elective 

print 

a  n  d 

o  1  L 

nodes  will  be 

printed. 

PS 

a  n  d 

PS  N 

cards 

may  be 

mi  xed 

and 

m  a  y 

appear  in  any 

order. 

.1  -  ;>  -  I  1 


OUTPUT  /  POSTS K  1) 


PO  CARD  Selective  Plotting  by  Node  or  !■• lenient 


Opt  i  mm  J 


Field 

Co  1  .  1  - 

Col.  2 


Variable 


_ L'e  scnption 

Card  Peyword  =  PC 


Col.  3 


I PTYPK 


See  description  of  this  field 
on  PS  card  above 

Type  ot  plot  desired  tor  the 
I  nl  I  oi'i  d;i  nodes  or  elements 
It  =  |  Concentration  vs  tine 

If  =2  bed  change  vs  time 
It  =3  bo  tit  concentration  ant 
bed  change  vs.  time  plots  will 
be  proa  need  . 


I  WAN TP 


Node  or  element  numbers  lor 
p  1  o  1 1  i  n  j; 


NOTE:  PO  and  PON  cards  may  be  mixed  and  may  occur  in  any  order, 

ii  omitted,  no  plotting  will  occur. 


OUTPUT/ POSTSED 


J  -  2  -  1  2 


AX  CARD 


plot  Axis  Limits 


Op t i on  a  1 


Kiel  <1 

Col.  1  - 

Co  1  .  2 

Co  1  .  1 


Variable 


Do  s  c  r  i  p  t  i  o  n 


Card  keyword  =  AX 


Must  be  "1)"  (for  bed  change)  or 
“ c ”  for  concentration).  If 
axes  limits  apply  to  bod 
change  plots.  If  "0,"  axes 
limits  apply  Lo  concentration 
plots  . 

Minimum  value  lor  X-(time)  axis 
in  model  seconds 

Maximum  value  lor  X— (time)  axis 
in  model  seconds 

Minimum  value  tor  Y-(data)  axis 
in  metres  or  K,;  /  cubic  metre 

Maximum  value  tor  Y-(data)  axis 
in  metros  or  K;;/ cubic  metre 


iJOTKS  : 


For  X-axis  self-scalin;;,  set  XM  1  N  =  XM  AX  =  l> .  0 
For  Y-axis  self-scalinj;  ,  set  YM  I  M  =  YH  AX  =  D  .  <) 

1;  no  AX  cards  are  present,  all  plot  axes  will 
be  self-scaled. 

l!  both  boil  change  and  concentration  plots  are 
to  be  produced,  two  AX  cards  may  be  inserted. 


J-2-  n 


OUTPUT/  1' 0 S'I  SKI) 


CARD 


Graphics  Type  Selection 


Opt ionn 1 


Field  V  .triable  _ Description _ 

Co  1  .  1  -  ICG  Card  keyword  =  GT 

Col.  2 

1  TPTYPF  Selects  the  graphics  system  u  s  c  i 

to  display  plots 

11  IP TYPE  =  0,  produce  printer 
plots 

If  IPTYPK  -  1,  use  GCS/'IKTA  and 

create  a  plot  I  i  l  e 

>;o  TK  :  if  no  GT  card  is  supplied,  printer  plots  will  be  used. 

If  the  GCS/MKTA  option  is  selected,  the  user  mist  supply 
an  appropriate  plot  file  name  in  the  call  to  I’KOCIA. 

The  CCS  MKT A  option  can  be  exercised  here  and  the  result 
changed  to  a  printer  plot  d  urine,  execution  oi  MKT  A  (see 
Appendix  I  )  . 
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1-2-1  '• 


<>1  /  H  3 


AbDKMlPM  J-J:  ACK 


Purpose 


I.  Program  ACK  produces  calculated  results  from  runs  ol  the 
sedimentation  model  STlIllll.  It  uses  the  STtlllH  output  results 
lilt.',  1 1 '  I A  —  2  V  output  results  file,  and  mesh  geometry  lile  to 
calculate  sediment  transport  rates,  shoaling  volumes,  and 

dredging  volumes,  and  to  create  vector  plots  of  unit  sediment 
discharge. 


Origin  of  the  P r  o  g  r  a  m 


2.  This  program  was  developed  by  modifying  VPl.OT  (APPKNI)IX 
L,  Addendum  1-2).  The  developers  were  William  A.  Thomas,  James  |t. 
KL bridge,  Jr.,  and  J.  Phillip  Stewart,  Hydraulics  Laboratory, 
Waterways  Experiment  Station. 


lies  r  i  pt  i  on 


3.  ACL  is  a  ba t c h -o r i e n t e d  program  that  reads  KNCMET 
(Appendix  >i)  output  files  »t  the  GKGK.t;  (Appendix  11)  finite  element 
network  and  the  KMA-2V  hydraulics;  it  reads  the  STU11H  output  file 
ot  sediment  concentrations  and  changes  in  bed  surface  elevation; 
it  reads  card  imago  input  data  that  control  the  execution  and 
then  produce  the  requested  vector  plot  files  and  printed  shoaling, 
and  drudging  volumes. 


Pro. 

.1  nets 

o  f 

tlic.1  n  id.;  ram 

a  r  e  : 

<3  • 

Vector 

plots  ot  seel 

ime.nl  d  i  s  c  ha  r  g  e  a  t 

selected 

tine 

St.’ 

ps  . 

;!• 

Ve  ctor 

plot  o ;  no t 

sediment  d i s  e  h  a r g  e 

over  a  com 

p l e t  e  STL  Hh  run. 

c  . 

Pint 

s  o 

f  ho  a  I  i  n  ■;  a 

i  s  t  r  i  l)ii  t  i  on  (ft,  c  n 

ft,  a  n  A 

;>e  r  c . 

»•  11 1 

ol  total)  e>  v  e  r  distance. 

d  . 

Ta  S  n 

1  ;i  r 

list  i  m;s  o  t 

s  h  o  a  1  i  ng  vo  1  ei  me  s  . 

!_  * 

T.ihu 

!  ;i  r 

listings  o  j 

ma  i  n  t  e n  a  nee  d  r  d  g  i 

n  g  v  .1  1  unes 

t  . 

Tahu 

1  «i  r 

1  i  st  i  nj’.s  oi 

model  to  prototy pe 

ratios  ni 

s  1.  o  a 

)  i  n 

•?\  vo  1  mu i*  s  • 

r’-  'lhl'  s,.,l  i  men  t  discharge  rate  is  calculated  at  every  node; 
however,  plotting,  can  he  restricted  to  selected  nodes  or  windows, 
f  i  ■*  program  docs  not  yet  allow  t  ho  uni  form  grid  option  that  is 


.1-  1-1 


OPT  PlPf  ANALYSIS 


/  U  J 


DRAFT 


available  in  VP LOT,  only  values  at  the  tinite  element  nixie  loca¬ 
tions  are  plotted. 

'■>•  Vector  lengths  are  sealed  to  the  unit  sediment  discharge 
at  the  node,  and  the  tail  ot  the  v  (  tor  lies  on  the  node  coord  i- 
n  a  t  <*  s  . 

Tnst  a  ntan  c  ous  s  c  d  i  ni  o  nt  d  i  s  c  ii  a  r  \\ c 

1.  The  sediment  concentrations  iron  STl'lih  are  converted 
I  nn  l.j/ia  Vsi'C  to  <1  i  s  c  1;  a  r  v  o  in  tons/il  ,iy  /  l  out  o  I  width  u  s  i  n  ;  the 
I  »  1  1  i'w  i  it;  e  'i  u  a  t  i  o n  s 


OS 


X  =  Coil  *  c  *  II  *  I! 


t.lSy 


COKK  0  *  v  *  h 


whir  e 


C  0  K  F  =  . ;  h  ,  4  o  0  (sec/day)  *  3.282  ( i  t  2 / n  2  ) 

1/2  100  (ton/  •••• )  *  1  /  1  »nn 

=  2 h  .01335  sec  x  tons  x  ppp 

day  x  "'2  x  |-L  x  npT 

C  =  sediment  concentration  in  POT 

I)  =  de  n  L  It  i  n  ne  t  re  s 


u 

=  x-vuloci 

i  y 

romponont 

in  m  /  s 

V 

=  y  -  v  e  1  o  c.  i  t  y 

co  n  po  n  o  n  t 

i  n  n  /  s 

p  p  p 

=  p  a  r  t.  s  o  1 

S  {' 

i i me  n t 

pe  r 

part  o 1  mixture 

P  FT 

=  parts  ol 

s  l* 

it  i  me  n  t 

r*«*  r 

1  m ( i  n  p  .  i  r  t  s  ( )  *  n j  y  tur 

lint;  t  he 

(  *  .  y  )  _P  1  nil 

•i.  Two  stales  are  required;  (a)  the  scale  'or  |  'nuin 
the  (  x  ,  y  )  plain-  and  (b)  the  vector  Inn.;  th  scale.  I  hi  (  x  ,  y  )  pi  a 
is  sealed  lor  0A1. Mi:;"  plots  hy  pr<-ser  i  hi  n>;  the  seali  ;  act  or  in 

prototype  units  per  inch  (i.e.,  it/  inch  ol  plot).  dr,.p'  jl  :, 

terminal  pints  lit  the  i  -tape  to  a  reduced  screen  •;!/,  tl  ,i  .,  |  I  , 
1  or  t  i  1  t  i  n  and  1  e ;;  e  n  d  space  around  t  h  •  ■  i  ,'ia  ;  >  ■  . 

l>  ■  1  !'  e  'hi  .in  tor  all  plots  is  d  i  ■  t  e  r  n  i  n  e  d  a  : 
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;  i ::  (  ruM)  ([,!)) 


i 


I  to  iiiutiIkt  of  no  d  o  s 


Y /.!.!•: i j  !  i ;,  (  con  I)  (  I  ,  2 ) ) 

iic  r  i * 


» . * ) W  i ■  (1,1)  -  x-coord  i  ii.i  Lc  o  i  node  1 
-  (1,2)  -=  v -coordinate  o  t  node  I 


1  ‘  ‘  ( \  , v )  positions  are  then  converted  to  plot  inches  hy 

OH’  I)  (1,1)  =  (COKh(I.I)  -  XZKKO)/XS 
u i; n  (i,2)  =  (<:ori>(i,2)  -  y/.i:i:o) /ys 

v-.  iii-  r  .  • 


S  -  seal- 

i  n 

r  ho 

x-d  i  reel  i  o n  , 

pr  o  t  o  t y  pe 

units/incii 

S  -  scale 

i  n 

t  ho 

y -d  i  reel  ion  , 

p  ro  t  o  t y  pe 

units/ inch 

..  o  r  n.i  1  1  y  ,  MS  is  o  .  ]  n  a  I  to  Y  S  ,  which  produces  un  <1  i  s  t  o  r  t  od  plots. 

Sc  a  1  i  n vector _ lengths 

I  i.  T  a  «•  o  t  lie  r  sc..!c,  vector  length,  is  somewhat  more 
com  ;>1  i  c;i  t  oil  to  describe  because  two  .lilferent  sets  of  data  appear 
,i  s  vector  plots: 


,j,  foe  i  ii  s  taut  a neons  mass  rate  of  sediment  trans¬ 
port  per  loot  width  for  each  time -stop,  and 

l) .  Thi'  a  c  c  ii  in  u  1  a  t  e  d  mass  per  foot  width  over  a  1  1 
time-slops  in  t  lie  simulation  period. 


1  I  . 


a  c 


a  1  i 


instantaneous  mass-rate  vectors. 


The  STh’DII 


,,ri.  r,Mn  will  write  the  e  o  n  re  n  l  r  a  t  i  o  n  s  and  accumulated  bed  changes 
t  „  t  t, output  file  for  the  initial  condition  and  for  each  tine- 
nilntioii.  Abb  will  read  that  till 


,  i  *  p  in  the  s  i  >n> 

■  .i  t  c  ») :  unit  fuss  !  i  s  c  !•  r 


calculate  the 


1  i 


i  I  1  coir'i  rt 

/■:  •/  •  ...»i  ..I 


t  ■  a  t 

.•/  i  t 
The 


(  t  o  »»  s  /  <!  ,i  y  / 

-i  .) 


re  t 

■  ner  1/2  i nr 
i  i  r  h i  option 


l  mu  of  w  i  d  t  li  )  tor  each 
to  p  l  .it  ’  i  11  c  ^  1 


u  s  i  n 


plot)  or  !iX  V  S  I  ;  i 
;  (.12  nr.i)  is  .is 


!'Sx  / 


V  =  OSy/VY 


S  =  vector  n  a  s  s  -  <!  i  s  c  h  a  r  «,  e  rate  scale  i  n  t  h  ex  -  d  i  r  e  r  t  i  o  n 
(  toiis/ilay/ft  )/(  1/2  inch) 

i;  -  t  lie  i  i  |  e  n  1  a  f  el  x  -  c  o  m  p  o  n  <•  n  t  o  t  t  h  e  p  '  o  t  vector  i  n 

i  MClU’S 


1-1-1 


(UriftT  ANAI.YS1S 


04/85 


r\P  *y 

b'>\- 

.  - -  - 1 


i 


VVS  =  the  vector  mass  ,liscliar;;i'  rate  scaLe  in  tlie  y- 
di  recti  on  (  t  on  s  /  <1  a  y  /  f  t  )  /  (  l  /  2  i  n  c  li ) 


the  calculated 
inches 


y -component  of  the  plot  vector  in 


\ 2.  The  other  vector  length  scale  opt  ion  is  based  on 
exceedance  frequency.  That  option  allows  the  program  to  a u soma¬ 
tically  scale  vector  lengths  without  us  ini;  the  maximum  mass  rate 
value  to  develop  the  scale.  The  benefit  is  that  one  extreme 
value  does  not  suppress  the  lengths  of  an  entire  plot  file. 


11.  The  exceedance  percent  allows  that  percent  of  mass 
discharge  rates  to  exceed  the  magnitude  of  the  vector  plot  scale. 
Consequently,  when  the  plot  l lie  is  created,  vector  lengths  may 
exceed  the  permissible  value  prescribed  hv  VHC'-lAX  ( J  2  card)  in 
inches.  Such  an  occurrence  causes  the  program  Lo  li  i  g  li  1  i  g  h  t  the 
nodal  value  by  a  heavy  arrowhead  when  either  Liu  x-  or  the  y- 
eomponent  exceeds  VKCMAX.  When  both  components  exceed  VKCI'AX, 
vector  direction  defaults  to  +  45  d  <;  i;  from  the  +  x-axis  in  addi¬ 
tion  to  the  heavy  arrowhead. 

14.  I s  u  a  1 1 y ,  an  exceedance  value  of  10  percent  is 
tolerable.  The  proa  ram  uses  5  percent  it  lett  in  default  mode. 

15.  Scaling  tne  accumulated  mass  vector.  The  other  set  of 
data  presented  as  vector  plots  is  the  accumulated  mass  ot  sedi¬ 
ment  moving  at  the  node  over  the  simulation  period.  The  sane 
scaling  concepts  apply  as  described  above  for  mass-rate  vectors, 
hut  different  variable  names  are  supplied.  The  variable  prescri¬ 
bing  tons  /toot  ot  wicltn  is  HOlilZ.  (The  companion  variable,  VK  FT, 
defaults  to  Ho  I<  I  . )  The  v  a  r  i  a  b  1  e  for  the  exceedance  option  is 

K  X  V  S  A  M  (card  J 1  ,  field  7 ) .  because  values  will  have  units  of 
tuns/ I  out  r  a  t  hot  than  of  tuns/dny/ foot  ,  the  vector  length  scale 
will  probably  be  different  than  that  of  instantaneous  values. 
Plotting  accumulated  vectors  mass  highlights  nodes  having  maxi¬ 
mum  or  minimum  sediment  d i s c ha r go  ,  w h i ch  will  reflect  sources  and 
sinks  in  the  study  area.  Paths  of  net  sediment  motion  will  he 
shown  .i  1  s  o . 


(  o  m  p  u  t  i  n  r  shoaling  and  cl  r  edging  volume; 


lb.  Adi:  Computes  volumes  of  sedimentation  and.  d  rod.;  i  r  .• 
requirements  by  accumulating  RTIM1H  results.  It  takes  each  S'l'l'in, 
run  output  as  one  event  and  multiplies  the  depth  changes  tor  that 
event  by  the  specified  number  of  times  that  event  is  expected,  to 
occur.  For  example,  const  d<  a  STbmi  run  Lb.it  represents  one  .  i . , «. 
O  i  S  e  (I  i  m  e  n  tat  i  o  n  a  t  a  g  i  v  e  n  river  flow  if  t  H  at  i  1  ■>  w  ore  e  r  s  >  5 
days  per  year,  AC.-l  will  multiply  the  STl'  I)  H  -  c  o  m  pu  t  .  lied  e  ,.,e  at 

each  node  by  1 5  and  add  those  results  L  o  any  other  ■■  v  e  n  I  >.  in  r  I  , 
series.  Ky  1  inf  in  g  events  lor  several  r o p r o so n t a t  i  ve  ■nsebar.es, 
an  entire  %  ■  •  a  r  i  !  sedimentation  results  can  he  r  i  leu  I  at’  *1. 


1/.  Sho.-I  ling.  Shoal  inn,  rates  are  calculated 
i  1  "  m  c  ■  n  t  s  by  a  e  e  e  ■■  i,  I  i  t  i  n  q  I  i  ■  d  c  h  a  n  ;;  e  s  for  II  e  v  i  u  I  s 


1  1 
r 
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durations.  Shoaling  is  deli  neb  as  net  bed  changes  —  the  a  1 q  e  b  r  a  i  c 
i  nto  ;ra  l  or  d  ♦  •  p  t  h  changes  over  an  olment.  Thus  equal  quantities 
i)  :  erosion  and  deposition  in  an  element  will  load  to  a  zero 
shoal inq  rate  t  or  that  element. 

1  h  •  hr  ed  g  j  n>; .  Like  s  h  o  a  L  i  n  q  rates,  <1  r  e  d  q  i  n  q  rates  are 
c.i  leu  la  ten  for  specified  elements  by  accumulating  bed  changes  for 
all  events  an.?  their  durations.  However,  in  dredging,  negative 
vu |  mu  s  do  not  oil  set  positive  volumes.  Deposition  quantities 
a  f  d  *’  a  r  a  s  dr  «  J  ;*  i  n  >,  v  o  I  u  ro  e  s  only  if  they  result  in  a  w  a  t  e  r  d  e  p  t  h 
less  lImii  the  specitiid  channel  dimensions. 

1  f).  Dr  e  I  q  i  n is  trip,  qe  red  at  a  node  it  the  calculated 
bottom  elongation  is  above  the  specified  channel  bottom.  Once 
dred-,in,  is  tri.ered,  the  dredged  volume  is  calculated  to  be  the 
quantity  needed  to  restore  channel  depth  plus  o ve r d r e d g i ng . 

Ovi  r  *!  r  od  ,  i  n  (specif  Led  on  the  DO  card)  can  be  any  combination  of 
advance  maintenance  and  allowable  overdepth,  hut  only  one  value 
i  s  p«*  flitted. 

Use 


2t>.  \0L  is  executed  with  PROCLV.  A  typical  command  Line 

is  shown  in  Appendix  0:  I'KOCLV.  Current  procedure  may  differ 

f  r  on  that  t  y  p  i  c  a  1  o  x  a  n  pip,  and  it  can  bo  listed  by  request  i  n  g  t  h  e 
*  h  .*  Ip1  option  in  P  K  0  C  L  V  . 

2  1.  \  C  K  uses  five  input  files  and  three  output  files.  They 

are  summarized  in  Table  J-3-1. 

2  2.  A C K  c rentes  a  plot  tile  which  can  t  h  e n  be  dir  e  c ted  t  o 
either  a  graphics  terminal  or  pen-plotter  using  MKTAPLOT 
(  A  p  p  t’mlix  J  )  . 


The  out  i  r»'  study  area  can  be  plotted  or  plots 

l,.rt  in.’  nodes,  .’lomunts,  or  a  plot  window.  A 

ci.  'or  I'.u’l  time -slip  pins  an  a  cc  u  m  u  l  a  t  °d  mass 
c,mI  tor  the  out  i  ri'  simulation  period. 


ran  he 
plot  can 

pint  can 


K  x  a  m  p  1  e 


;?  |  #  K  i  ;  u  r t  .1-1-1  shows  an  example  card  listing  tor  creatin' 
1‘tnr  plots  an-1  a  dredging  computation. 

Lard  Ima  .<•  Data  Input  Instructions 


2  2.  The  input  data  should  t>  e  coded  in  <y  —  e  o  1  u  m  n  fields  will 
in-  card  type  in  columns  1  and  2.  Table  J-l-2  snmm.-ri/es  input 
I  a  t  a  .  Lod  in*  d  «•  t  a  i  1  s  follow.  o  o  v  m  p  T  e  is  s  b  «>  w  n  i  n  A  I*  **  >■  f]  s 
•.  \  A :  *  I*  Id-.  I1  It  (i I? Id .  ‘  1 . 


Tab  lo  .1  —  3  —  2 

Summary  of  Card  In  a;;  e  Run  Control  Input  f  o  r  A  C.  K 


Oa  r  d 

Content 

1>  a;;e 

1 1 

T  L  t  1  e 

J-1-H 

j  i , j? ,  n 

J  o  h  pa  r  a  me*  t  e  r  s 

3  —  3  —  9 

VT 

l'imo-step  selection  tor  plots 

3-3-1  3 

IT 

1  i  r,i  a  -stop  select  i  <>  n  t  o  r  tables 

3  -  3  -  1  A 

V  ,\ 

Victor  plot  no  d  e  selection 

1 

1 

VP 

\i\: 

lie  c  t  a  n;;  u  L  a  r  window  option 

3-3-16 

Vector  plots  element  selection 

3-3-17 

l.K 

Mo  sb  plot  element  selection 

X 

1 

1 

l>  N 

Printed  results,  node  selection 

1 

ro 

1 

DU 

Dr  e <1  ,  i  n  t  options 

J-1-2D 

in: 

lire  d  ",  in.;  1  o  c  a  t  i  o  n  s 

J  -  3  -  2  1 

S  0 

idiot)  1  i  n:|  volumes  option,  model 

J-3-22 

Slioalin",  locations,  model 

.1-1-23 

s  ;* 

S  lion  line,  volumes  option,  prototype 

.1-3-24 

s  \ 

Shoalin',  locations  and  volumes,  prototype 

.1-3-2  3 

r:> 

r  ent  s  e  ij  lie  n  ce  till  c 

.1- 1-2ti 

>D 

1  >.  ruts  d  u  rat  i  on 

1 

1 

N3 

*  '  : 

:  •  i  «  1  ,  t  i  f  e  ( )• .  m  a  n  -  J 

'  v  r  ii  t  dccmmi  )  a  L  ion  r  e  s  « J  L 

3-3-29 

n  .1  n  1  i  o  b 

.1  -  1-3D 

J  -  1  -  7 
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J1  Card 

Field 

0 

1 


2 


Job  Parameters 


Variable  Value 


J1 


10PTI0N 


0 

1 


2 

3 


4 


J  CON  C 


0 

14 


I  DSC 


0 


1 


ITSHOL  0 

1 


_  Description _ 

Card  Identification 

Vector  plot  scales  and  shoaling  and 

dredging  computations  are  controlled  by 
the  I0PTI0N  parameter.  Must  be  0  If 
N F I LE S> 1  on  J3  card. 

No  vector  plot.  Shoaling  and  dredging 
computations  are  made. 

A  vector  plot  is  made  and  the  scale  is 
described  with  input  data  (J2  card, 
field  5  and  J2  card,  field  6). 

Vector  scale  is  calculated  at  each  time-step 
in  each  event . 

The  same  vector  scale  is  used  to  plot  all 
t 1 m e - s t e p s i na ne v e n t .  (not  yet 
available) 

The  vector  plots  all  use  the  same 
scale  at  all  time-steps  in  all  events. 

The  logical  unit  for  saving  calculated 
bed  change  results  from  the  shoaling 
and  dredging  computations. 

Results  will  not  be  saved. 

The  results  are  saved  on  logical  unit  14. 

A  logic  control  record  for  reading  the 
STUDH  concentration  file  (ICONC). 

STUDH  output  file  having  three  records, 
title,  geometry,  DBe d - con cen t r a t i on , 
with  Delbed  concentration  repeated 
for  each  line. 

A  "GET"  file.  The  three  records  are 
present  for  the  first  events  but 
thereafter  only  three  exist  for  the 
last  time  step  in  remaining  events. 

No  trace  printout  will  be  produced  during 
the  shoaling  computations. 

Trace  printout  will  be  provided  in  sub¬ 
routine  SHOAL. 


J  -  3-9 
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J1  Card  (Continued) 


Field 

5 

6 

7 


8 

9 

10 


Variable  Value 


Description 


ITDRG  0  No  trace  printout  in  subroutine  DREDGE. 

1  Trace  printout  will  be  provided  in  subroutine 

DREDGE. 


ITRON  0  Only  the  final  results  are  printed  from 

subroutine  EXCEED  showing  scale  computation. 

3  A  table  showing  the  percentage  of  concentration 

in  each  class  interval  for  the  total  20  class 
intervals  . 


EX VS AM  0  -  100  The  vector  scale  length  in  subroutine  EXCEED. 

It  is  the  percentage  of  nodes  that  can 
have  the  accumulated  mass  vector  equal 
to  or  greater  than  the  maximum  vector  length. 
The  consequence  is  that  a  heavy  arrowhead  is 
placed  on  the  end  of  the  vector.  Usually  up 
to  half  dozen  or  dozen  of  these  in  a  plot 
of  a  thousand  nodes  is  tolerable. 

EXVSGM  0  -  100  The  accumulated  mass  plotting  scale  when 

a  "global"  scaling  requirement  is 
requested  (J1  card,  field  1).  (See 
EXVSAM  above.) 


EXVSIM  0  -  100  Vector  scale  for  an  instantaneous  mass  vector. 

It  should  be  included  even  if  the  previous 
two  variables  have  been  used. 

IPC  IPC  controls  whether  velocities,  concentrations, 

and  bed  change  values  will  be  printed  or  not. 
It  is  optional  and  works  only  if  NFILES  -  1 
on  J3  card . 


0  No  printout  will  be  made. 


1  The  velocities,  concentrations,  and  bed 

changes  will  be  printed  at  the  nodes  selected 

for  plotting  vectors.  Consequently, 

that  option  has  to  be  exercised  (PT-card). 

2  Velocities,  concentrations,  and  bed  changes 

will  be  printed  for  nodes  read  in  card  PN. 
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J2  Card  Job  Parameters  (Continued) 

Field  Variable  Value 

0  J2  Card  identification. 

1  XS  +  The  grid  scale  factor  of  the  X-coordinate 

(units  per  inch). 

2  YS  +  The  grid  scale  factor  of  the  Y-coordinate. 

3  HORIZ  Horizontal  scale  for  plotting  accumulated 

mass  vectors  in  units  of  tons  per  day 
to  foot  of  width  for  each  inch  of 
plotter  paper. 

4  VERT  NOT  PRESENTLY  AVAILABLE  FOR  USE. 

5  HHS  +  Scale  for  plotting  Instantaneous  mass  movement 

at  each  time-step  in  units  of  tons  per  day  per 
foot  of  width  for  each  inch  of  plot. 

6  VVS  -  Vertical  scale  vector  a  comparison  to  HHS 

above  for  possible  later  expansion. 

7  ISF. L  A  logic  variable  for  partial  grid  vector  plots. 

-1  Use  the  rectangular  window  option  by 

prescribing  the  number  of  the  minimum  and 
maximum  X  and  Y  nodal  point  values  in 
the  grid.  (Need  VW  Card) 

-2  Nodal  points  will  be  selected  by  reading 

in  element  numbers.  (VE  Cards,  which  follow). 

0  Mass  vector  will  be  plotted  at  every  node. 

+1  A  list  of  selected  nodal  point  numbers  will 

be  read  from  cards  VCN. 

8  ITNN  0  Node  numbers  are  not  written  on  the  plot. 

1  Node  numbers  are  written  by  each  vector  plotted. 

9  ISTEPS  +  This  controls  the  number  of  records  read  from 

tape  ICONC.  STUDH  output  files  have  time 
concentration  and  bed  change  data  for  the 
entire  run.  Only  the  ISTEPS  record  is 
saved  Internally  by  code.  ISTEPS  must  equal 
NTTS  on  the  TZ  card  of  the  creating  STUDH 
run  control  file. 

10  VECMAX  +  The  maximum  length  of  a  vector,  usually 

1.0  in.  is  satisfactory. 


Description 


J-3-l  1 
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E 


J3  Card 
V  i  e  1  d 

U 

1 

2 

'3 


Re  t|  u  i  r  e  d 


Variable  Value 


lli'scri  p t  i  on 


J  2  Card  ident  i  I  1  cat  ion 


,-n:xi 


MSTKPS 


13  T 

N  F  1 I.  h  S 

I SHPLT 


Number  of  extrapolations  used  in  STl'iii1 
run.  (Note  that  this  is  one  less  than 
the  value  of  MEX  in  the  ST  l'  nil  run.) 

+  Number  of  tine -steps  on  ti.\C. 'll  ,T  velocity 

and  w a  t  e  r - s  u  r  f a  c  e  output  tiles. 

+  Length  of  time-step,  sec 

+■  Number  of  STI'liH  output  files  to  be  read 

(  s  e e  p a  r  a  g  rapri  7  ) 


Shoaling  i 

i  itri  hut  ion 

plot 

opt  ion 

+ 1 

Cubic  feet 

V  s  . 

rivur 

mile 

+  2 

Cubic  feet 

vs  • 

river 

n  i  1  e  a 

nd  percent 

shoa  1  i ng 

V  s  • 

r  i  v  o  r 

in  i  1  e 

+  3 

Cubic  feet 

vs  • 

r  i  v  i*  r 

in  i  1  e  , 

p  e  r  e  e  n  t 

shoal  i  n g 

V  s  • 

river 

mile, 

a  n  i! 

feet  of 

shoaling  vs 

.  rive 

r  mile 
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.1-  i-  I  ;> 


VT  C.i  r  d 


Selected  iii'K'Sti'iis  tor  Vector  I’ lots 


Uni  i  t 


i  t 


i  K  i'  (  Ah  ,  !  OUT  ) 

•\n  i0  —  co  In  nil  record  having  VT  in  columns  I  aiul  3  iol 
tiui  value  1  corresponding  to  tlie  tine-step  wtiure  sucli 
n  ass  r  ,i  t  e  plot  is  requested. 

To  plot  tin'  a  c  o  mini  1  a  t  cd  mass,  code  1  in  tlie  column  1 
last  t  ine-step  nnnher . 

'  ■  o  1 1'  :  I  li  i  s  card  is  not  coded  in  S  — column  fields.) 


Ke  q  u  i  r  e  d 
if  1  0 1’ TO  a  >  0 
NKII.I.S  >  1 


lowed  by 
i n s  t  a n t  a n cous 


olowing  the 


PT  Card  SclfCtcJ  Timestcps  tor  Printed  Results  Reiju 

I  PC 

I  FF(  AD  ,  Kl’T  It ) 

An  :•>  0  —  c  o  1  ii  i'i  n  record  tavim;  PT  in  columns  1  and  2  tollowe 
ttie  value  l  cor  respoiul  in;  to  the  tine-step  to  wliore  tlie  con 
tration  and  bed  change  printouts  are  requested. 


i  r  e  it 
=  1 


d  b  y 
c  e  n  - 
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V.t  Card 


Vector  I’lols  ,  Si'  I  I'cti.'d  Nodes  Options 


lie  cpii  red  it 
I  S':  L>0 


Licit  Variable  Value 
«>  1\  V  M 

1  I :« (  I  ;  + 

2  l IS  1:1.)  + 


1  N  s + 

2  1  N  (  1  )  + 

i  i ::(... )  + 

Com  t i n  u  ati on  Cards 

11  IX  VI. 

1  I N ( 10)  + 


1  ' )  e  t  c  . 


_ Description _ 

Card  identification. 

Knter  the  lirst  node  number  where  vector  is 
to  he  plotted 

Continue  codin,;  1  0  nodes  per  card  until 

all  nodal  points  have  been  entered  for  the 
vector  plots. 

Inter  the  number  of  nodes  coded  on  VN  cards 

First  node  number  where  vector  is  to  be 
plotted.  Sequence  is  not  important. 

Continue  entering  node  numbers  until  NSN 
values  are  coded. 


Card  identification 

Continue  coding  10  numbers  per  card 
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VU  Card 

F  i  e  1  d 

I 

1 


hect angular  Window  Option 


Ho  'i  n  i  r 
IS  CL  = 


Variable  Value 


llescrlptiun 


VU 

Card  identification 

PXM1N 

+ 

The  nodal  point  number  for  the 
h  a  v  i  ii;]  the  minimum  value  in 

I’XMAX 

+ 

The  nodal  point  number  o t  the 
bavin,-;  the  maximum  value  in 

PYM  I  X 

+ 

The  nodal  point  number  of  the 
having  the  minimum  value  in 

PYMAX 

+ 

The  nodal  point  number  ol  the 
bavin,",  the  maximum  value  in 

d  i  I 

-  ) 


X  -c  oo  ri1  in  a  t  e 
1 1)  e  w  i  ml  ow  . 

X  -  e  o  o  r  d  i  m  a  l  e 
Lhi’  w  i  n  ri  u  w  • 

Y -coo r  I  in.it  o 
1 1 1  c  •  window. 

Y -c oo  r d i n  a  t  o 

t.  he  w  i  11  d  o  W  . 
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VI  C ..  i  t 


Vector  I’  1  i)  t  s  ,  Sili  cLui!  Clement  Option 


V.iri  a  I)  1  e  Valui 


IKI.i'T(l)  + 


IKU!T(  .  .  +■ 


Continuation  C;i  r  <J  s 


1  IK  crii(  10)  + 


it e  i]  u  i  r  *  ■  ii 
ISlil.  =  - 


_ Description _ 

Ca  r  i!  identification. 

Tlie  number  of  elements  to  be  read  in. 

Tlie  first  element  numbers  at  which  the 
velocity  vector  is  to  be  plotted. 

Continue  entering  element  numbers 
until  NELA  values  are  coded 


Card  identiticatii 


Continue  coding  10  numbers  per  card 


.1-1-17 
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OK  Card 


St1  loci  lli’iiii'iits  lor  tlio  Mesh  Plot 


Field  Variable  Value 


I  HAVE (  1 )  + 


1  H  A  V  F.  (  2  ) 


_ _ Description _ 

Card  i  d  e  n  t  i  1  i  c  a  t  i  <>  n  . 

The  number  of  elements  coded  in  this  data  si 

The  first  element  number  for  which  tin*  mesh 
will  be  plotted. 

Continue  codin;;  all  10  fields.  Start  con¬ 
tinuation  card  with  OF  hi  columns  1  and  2 
and  code  all  10  tie  Ids  per  card. 
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I'  >  <  >  rd 


Si'  I  «-c  t  i*if  Nodes  lor  |  r  i  nloul 


Re  q  u  i  r  or!  i  I  IRC  =  '? 

pro  so n  t 


V  .1  r  i  .1  b  1  i 


Description 


fa  rd  i  ;lo  n  t  i  t  i  c  a  t  ion  . 

NNPC  nodes  liavo  been  selectee!  for  printout. 

'first  nodal  number  where  printout  is  requested. 
They  may  he  in  any  order,  but  the  printout 
is  made  in  the  same  order  as  values  are  coded 
on  the  card.  follow  cod  in,"  procedure  on 
previous  cards. 


Of'IPUT  ANALYSIS 


Field 

Variable 

Value 

Description 

0 

no 

Ctird  Idcnt  i£  ication. 

1 

NDP 

0 

°  d  red;;  in  a  locations  are  prescribed. 

+ 

"  1,  D  K "  dredi’int;  stations  are  coiled  on  ear  its 
wli  ich  [  o  1  low. 

2 

l)OIJ 

(' ,  + 

Depth  of  overtired  '.in  ,  tor  this  job.* 

DATUM 

-,o,+ 

latter  t  in’  datum  of  the  tired”,  ed  channel 

elevation  when  it  is  other  than  that  datum 
described  in  the  hydraulic  and  sediment 
computations  ior  the  estuary  elevation, 
e  .  V  .  ,  the  datnu  nlane  tor  channel  ih'pth 
nay  he  mean  low  water  whereas  the  datum 
[» 1  a  n e  ior  t  ho  noth’  1  s  n  a  s’  he  s o to e 
arbitrary  datum. 


*  fverdrerfj;  im;  is  used  here  in  the  sense  id  dr.-.'  -.in,,  a  ehan.nl  to 
a  depth  greater  than  the  desi»n  dept  It  for  any  reason.  The  uver- 
d  rede  e d  .mount  nay  be  allowable  overdepth,  advance  maintenance, 
otln-r  or  .ill  of  these. 
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I  •  r  “  .1  i  ii l.ui'alii'iis 


Opiion.il  i  ' 

N  0  !'  >  •  i  (1,0  card) 


iriahl.  Value  Destr  i  |>t  iun 


ill-  Oar.!  i  d  e  u  t  i  I  i  r  at  iuu  . 

I\  'i  I  1. 1  -  ,  1 )  ,  +  rliitci'  c  n  ii.iv  i;;al  inn  c  h  a  u  n  i*  I  mile  at  which 

Ji'i'd,,  i  Hi',  results  apply  for  tlmsc  elenciits 
coiled  on  this  card.  T h  i  s  value  i  s  lor 
spatial  ret .ranee  only.  It  Poes  not  outer 
into  the  Computations. 
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Shoal  in;;  Locations,  lotto  I  Data 


Required  i  1 

mi:  i.  i)R>() 


Variable  Value 


Do  s  c  r  i  [i  t  i  on 


Lard  LJi'nt  i  1  icai  iun  , 


*  i  (  L 1. 


.inter  tlie  channel  mile  at  which  shonlini; 
results  computed  for  the  elements  on  this 
card  should  apply.  (This  is  useful  tor 
correlating  computer  results  w i t h  prototyp 
d  ,i  t  a  and  maps  .  ) 


I  l)kCK(  I  ,  .  .  )  + 

1  bi'.Ll-H  1  ,  r:F.K)  + 


I  h  i  s  variable  permits  a c  cumu  1  a  t  i  ng  slioa  I  i  ng 
volumes  tor  more  than  one  element  to  be 
printed  at  the  location  or  mile  shown  in 
1  ield  1.  " NKN"  is  any  number  of  elements 
up  to  3 •  The  element  numbers  will  follow  in 
subsequent  fields  on  this  card. 

Lode  the  element  number  for  those  elements 

where  the  bed  change  is  to  he  computed  to  got 
a  shoal  ini;  volume  and  then  added  together 
lor  a  result  at  this  river  mile. 


Up  to  MhN  values  should  he  proscribed 
across  the  card. 
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SP  Card  Shoaling  VoLunes  Option,  Prototype  Data 


Required 


If  prototype  data  are  available,  code  t  h  e  values  on  the  S  M 
cards  which  follow  this  card  ami  the  program  will  calculate  ratios 
between  model  results  and  the  prototype. 


Field 

Variable 

Value 

Description 

1) 

SP 

Card  identification. 

l 

NPU 

0,+ 

No  prototype  shoal  in/,  data  are  included 
(no  S  N  cards) 

+ 

The  number  of  S\  cards  that  follow 

OUTPUT  ANALYSIS 


1  —  3  —  11  4 


T2  Card 


[{vent  Sequence  Title 


Re  q u i red 


Code  up  to  72  characters  of  t  tie  title  information  to  describe 
the  condition  of  the  events  which  follow. 

Events  are  discussed  in  p  a  r  a )'  r  a  p  h 


OUTPUT  ANALYSIS 


.J  -  T  -  2  f. 


SDK  I.  net. 


Command  C'.a  rd  -  Dreitjf 


Option  a  1 


This  command  causes  the  computer  program  to  calculate  the 
amount  ot  dredging.  At  the  end  of  event  analysis  results  are  Tinted 
in  terms  of  volume  as  well  as  percent  distribution. 
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1  'is  is  .i  special  control  to  reset  accumulators  wlien  more  than  one 
t  has  been  placed  in  the  job  stream  and  each  one  is  to  be;;  i  ii  with 
same  i n • t i a l  condition  lor  shoaling  and  dredging  which  is  the  vain 
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PART  I :  INTRODUCTION 


Object ive 


L.  This  appendix  discusses  what  field  data  are  needed  for  a 
node  1  in)',  el  tort  and  g  ives  an  overview  of  how  they  can  be 
obtain  e  <1  . 


Uses  of  field  Data 


2.  field  (prototype)  data  are  used  in  a  model  study  to 
describe  the  geometry  of  the  area  to  be  modeled,  to  identify  the 
important  processes,  to  provide  input  data  to  the  models,  and  to 
provide  a  standard  with  which  model  results  can  be  compared 
(veril ication). 


Sources  of  field  Data 


3.  Primary  sources  for  hydraulic  field  data  are  direct 
collection  of  the  data  and  the  publications  and  records  of  state 
and  federal  agencies.  A  combination  of  data  from  these  sources 
is  usually  necessary. 

4  .  Federal  agencies  collecting  substantial  amounts  of 
hydraulic  t i e  1  d  data  are  the  Army  Corps  of  engineers,  U .  S  . 
ecological  Survey  (USGS),  fish  and  Wildlife  Service,  Bureau  ot 
Reclamation,  and  National  Ocean  Survey  (NOS).  The  USGS  and  NOS 
publish  nearly  all  of  the  data  that  they  collect,  while  the  other 
agencies  publish  part  of  their  data  and  retain  the  rest  in  their 
files.  A  list  of  addresses  for  making  data  inquiries  is  given  in 
Addendum  K- I  .  Secondary  sources  of  data  include  universities, 
private  companies,  and  the  technical  literature. 


Special  Co nsid  orations 


Synoptic  measurements 


S .  Model  studies  exhibit  some  special 
lerent  from  most  other  uses  of  field  data, 
is  the  requirement  that  much  of  the  data  be 
over  the  area  of  interest  at  the  same  time. 


needs  that  are  dif- 
Prominent  among,  these 
synoptic,  or  taken 


f>.  Nearly  synoptic  data  are  needed  so  that  one  set  of 
boundary  conditions  are  responsible  for  data  at  all  locations  and 


K  1 


flf,  I.D  DATA 


so  that  relationships  can  be  established  between  processes  at  the 
data  collection  locations.  For  most  situations,  this  does  not 
mean  that  measurements  are  made  at  the  same  instant,  but  within  a 
time  interval  of  minutes  or  even  hours.  (Some  data,  such  as 
short  period  wave  measurements,  must  often  be  obtained  within  a 
few  seconds  at  several  locations.)  Where  circumstances  or 
resources  prohibit  nearly  synoptic  data  collection,  some  means  of 
compensation  must  be  applied.  For  example,  data  collected  on 
successive  days  might  overlap  where  one  station  is  sampled  every 
day  to  serve  as  a  reference  station. 

7.  Meaningful  verification  of  a  model  to  field  data  usually 
requires  that  measurements  must  be  made  over  the  area  modeled 
during  steady  or  quasi-steady  conditions.  For  example,  if 
several  ranges  in  a  modeled  reach  of  a  river  are  to  be  measured, 
the  measurements  should  be  made  for  an  essentially  constant  stage 
and  discharge.  It  the  stage  is  changing  slowly,  then  measurement 
at  all  ranges  during  a  1,  or  possibly  2-day  period  will  be  under 
sufficiently  constant  conditions.  For  a  tidal  waterway  where 
measurements  are  made  at  regular  intervals  over  a  tidal  cycle, 
optional  data  collection  occurs  when  the  tidal  range  does  not 
vary  dramatically  prior  to  or  during  a  survey. 

8.  Knvironmentai  conditions  prior  to  and  during  data 
collection  must  be  considered.  For  example,  if  the  process  of 
primary  interest  is  tidal  propagation  across  a  broad  bay, 
measurement  of  water  levels  during  a  period  of  a  sustained  strong 
wind  will  greatly  diminish  the  value  of  the  data. 

Vert  ical  contro  1 

9.  Establishing  an  accurate  datum  plane  for  water  level  and 
hydrographic  measurements  is  important  for  model  development  and 
use.  It  is  also  nearly  impossible.  Despite  claims  for  datum 
plane  accuracy,  level  nets  are  notoriously  inaccurate  lor  use  in 
obtaining,  water  surface  elevations  and  slopes.  In  tidal  waters, 
the  problems  are  worse  since  there  is  often  considerable  subsi¬ 
dence  and  level  circuits  over  marsh  and  water  are  so  diffi  ult. 
Because  datum  plane  measurements  are  so  inaccurate,  there  is  no 
particular  point  in  being  dogmatic  about  rigorous  vertical  con¬ 
trol.  Accept  whatever  you  are  given  but  do  not  believe  in  it 
very  much. 

Personnel  and  organization 

10.  Many  organizations  have  excellent  equipment  and  we  1  1  - 
trained  personnel  tor  collecting  field  data.  Fn 1 o r t u na t e  1  y  ,  that 
does  not  mean  that  they  are  able  to  make  field  measurements  that 
are  suitable  tor  use  in  a  model  study.  The  overall  design  and 
specification  of  a  data  collection  effort  should  he  done  by  the 
modeler.  The  detailed  design  and  execution  should  be  performed 
by  personnel  who  are  familiar  with  the  study  and  with  modeling,. 
The  modeler  should,  as  a  matter  ot  course,  be  present  and 
actively  participating  in  a  majority  of  the  data  collection 

e  t  t  o  r  t  .  Ignore  this  advice  at  your  peril. 
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Organization  of  the  Appendix 


II.  l’art  I[  of  this  appendix  describes  the  kinds  of  data 
needed  tor  a  model  application  and  where  the  data  come  from. 
Collection  and  analysis  methods  are  discussed  only  when  it  is 
necessary  to  provide  information  beyond  that  given  in  the 
"National  Handbook  of  Recommended  Methods  for  Water  Data  Acquisi¬ 
tion"  (USCS  1  ')  7  7  )  . 
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FIIII.U  DATA  MIKDS  AND  COLLECTION 


12.  This  portion  of  the  appendix  describes  the  field  data 
that  are  needed  in  a  model  study  and  discusses  some  aspects  of 
collection  and  analysis  methods.  Field  data  needs  are  summarized 
in  Tables  K  1  -  K  4  . 


All  Modeling 


13.  Data  that  are  required  for  all  modeling  efforts  include 
those  listed  in  Table  Kl.  Dank  lines,  bed  elevations,  and  struc¬ 
ture  details  are  needed  tor  generating  the  computational  network 
ot  the  prototype.  Most  of  the  data  can  be  obtained  from  charts 
and  photographs  of  the  area,  though  some  additional  surveying  may 
be  needed. 

14.  Since  structures  such  as  dikes  and  jetties  can  be 
represented  as  solid,  permeable,  submerged,  or  dry  in  the  TAKS-2 
system,  data  on  their  design  and  condition  are  needed.  The  mesh 
can  then  be  created  in  a  fashion  that  most  accurately  describes 
the  structure.  Side-scan  sonar  surveys  can  be  protitably  used  in 
some  situations  to  obtain  a  description  of  underwater  conditions. 

13.  Digitizing  of  data  from  charts  and  maps  is  discussed  in 
Appendix  H :  Digitizer  Instructions. 

16.  Analysis  of  successive  hydrographic  surveys  is  used  to 
generate  scour  and  fill  patterns  and  deposition  volumes  used  in 
sedimentation  model  verification.  This  use  of  the  data  is 
important,  but  the  previous  warning  about  vertical  control  is 
especially  pertinent  here.  The  modeler  must  remember  that  hydro- 
graphic  surveys  contain  both  random  and  systematic  errors. 
Systematic  errors  in  excess  of  1  ft  are  unfortunately  common.  It 
accurate  measurement  ot  bed  elevation  changes  are  essential,  the 
modeler  sit  on  Id  turn  to  techniques  other  than  soundings,  such  as 
sedimentation  stakes  or  density  profiles  over  artificial  reflec¬ 
tors.  It  should  also  be  noted  that  acoustic  surveys  of  fluffy 
bottom  material  can  be  very  misleading  (see  paragraph  37). 

Hydrodynamic  Modeling 

I  / .  fable  K  2  lists  the  field  data  requirements  tor  hydro- 
dvn.imir  model  i  n  g  . 

Water  levels 

I  “■  .  Water  levels  are  used  to  formulate  boundary  conditions 
and  t  o  calculate  or  estimate  bo  u  ml  a  r  v  roughness  coe  t  f icimit  s  . 
v.  s  t  a  b  1  i  s  h  i  n  g  an  accurate  vertical  datum  tor  the  water-level  data 
is  important,  hut  it  is  rarelv  achieved.  In  in  lane  waters,  the 
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levels  are  needed  tor  a  sul  licient  variety  o  t  mndi t ions  so  as  to 
represent  the  range  of  tlows  that  are  to  he  tested.  tor  exam¬ 
ple,  it  flood  flows  are  to  he  tested,  water  levels  dnrim'.  hip,  li 
tlows  are  needed. 

19.  In  tidal  waters,  several  tidal  cycles  or  continuous  or 

frequent  intermittent  water-level  measurements  are  .  led.  I'D. 

water-level  records  can  he  used  directly  and/or  in  analyze. I 
(phase  relations,  tidal  range,  or  constituents)  tnrm.  A  )o-min 
sampling  interval  is  usually  sufficient.  Durations  of  I  m  d  a v  s 
are  commonly  required. 

'2  0.  In  areas  where  vessel  traffic  or  wind  create-,  short- 
period  waves  at  a  water-level  gage,  some  eltorr  may  he  required 
to  t  i  1  t  e  r  s  ho  r  t  -  pe  r  i  od  oscillations  before  measuring,.  ordinary 
stilling  well  port  design  (a  circular  orifice  or  short  tube) 
transmit  short  pe  r  i  od  oscillations  to  the  well  nonl  ine.ir  1  v  ,  and 
po s t m ca s u r eme n t  analyses  cannot  reliably  remove  them.  linear 
stilling  well  ports  are  needed  (Fisackerly,  e t  a l  .  1  9  H  3  )  . 

Current  ve loci  tie  s/discharges 

21.  Current  speed  and  direction  measurements  are  used  to 
calculate  boundary  conditions,  either  as  velocities  or  dis¬ 
charges,  and  to  verity  the  model.  Direction  should  be  measured 
In  degrees  from  true  north.  For  some  boundaries,  such  as  power¬ 
houses,  disharges  may  he  obtained  from  the  operating  agency  and 
then  used  to  calculate  boundary  conditions. 

22.  Velocity  measurements  are  sometimes  needed  at  locations 
or  under  conditions  where  an  a  ho v e - 1 he -wa t e r  platform  (boat  or 
structure)  cannot  be  manned  for  the  desired  measurement  period, 
in  those  cases,  i  ti  situ  recording  meters  are  needed.  For  an 
example  of  in  situ  meter  application,  see  Fisackerly  et  al. 

(  19H5) 

23.  The  number  of  velocity  measurement  points  needed  at  a 
cross  section  depends  on  the  channel  width,  depth,  and  shape  and 
characteristics  of  the  flow.  In  general,  two  or  three  locations 
in  a  cross  section  art-  needed  with  at  least  three  points  measured 
in  the  vertical  at  each  location. 

Turbulent  exchange  and  roughness  coefficients 

24.  Turbulent  exchange  and  roughness  coefficients  cannot  he 
measured  directly.  They  are  a  function  ol  morphology,  1 1 ow 
characteristics  and  computational  mesh. 

S  e  d imputation  Model  i  n  g 

23.  Data  requirements  for  performing  sedimentation  modeling 
are  summarized  in  Table  K3.  Some  of  the  data  are  needed  for 
either  cohesive  or  non  cohesive  sediments  and  are  denoted  as  being 
always  or  usually  needed.  Some  are  needed  only  tor  one  type  ol 
sediment  and  that  is  noted  in  the  "when  needed"  column. 

K  3 
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Crain  sizes  an  d  s e  t  t 1  i  n  g  velocities 


2  8.  Sediment  grain  sizes  and  settling  velocities  must  be 
analyzed  he  fore  determining  values  to  be  used  as  model  input. 

The  input  data  needed  by  the  model  are  cl  fee t  ive  grain  size  and 
settling  velocity.  This  is  particularly  important  tor  settling, 
velocity  since  measurements  are  made  in  quiescent  water  (settling 
tubes)  whereas  the  effective  settling,  velocity  includes  turbulent 
resuspension  in  the  t 1 o  w . 

27.  Cohesive  sediments  exhibit  different  settling  veloci¬ 
ties  in  .he  laboratory  than  in  the  natural  environment.  This  is 
caused  by  changes  in  aggregation  of  the  particles  during  sampling 
and  storage.  Laboratory  measurements  of  settling  velocities 
should  be  supplemented  by  on-site  measurements  with  an  Owens 
tube.  See  Fisackerly  et  al.  (1985)  for  a  discussion  of  Owens 
tube  measurements. 

Concentrations 

28.  Sediment  concentration  profiles  in  the  vertical  are 
needed  even  In  a  two-dimensional  model  study.  The  concentration 
profiles  can  be  used  to  deduce  settling  velocities  and  critical 
shear  stresses  in  some  cases.  Standardized  equipment  and 
sampling,  procedures  are  described  in  the  Recommended  Methods 
Handbook  (USGS  1977). 

29.  Under  conditions  of  high  suspended  sediment  concentra¬ 
tions  and  steep  concentration  gradients  (sometimes  referred  to  as 
fluff  or  fluid  mud)  or  density  current  in  estuaries  and  reser¬ 
voirs,  discrete  sampling  of  concentrations  in  the  vertical  can 
lead  to  erroneous  conclusions.  The  behavior  of  very  fine  sedi¬ 
ments  in  high  concentrations  leads  to  irregular  concentration 
profiles.  It  such  conditions  exist,  continuous  concentration 
profiles  should  be  measured  by  delivering  a  densimeter  through 
the  water  column  (Parker  and  Kirby  1981).  Density  profile  infor¬ 
mation  can  also  be  used  for  establishing  bed  elevations  and  the 
unit  weight  of  bed  deposits. 

Bed  gradation,  density,  structure, 
and  consolidation  coefficients 


10.  Density  measurements  can  be  made  on  cohesive  bed  sedi¬ 
ments.  The  profile  of  bed  density  with  distance  into  the  bed  can 
be  determined  in  situ  by  a  densimeter  (Parker  anti  Kirby  1981)  for 
low  densities  and  by  laboratory  tests  on  slices  of  short  cores 
for  compacted  sediments.  Density  profiles  in  n  e  w 1 v  deposited 
material  may  also  be  measured  in  the  laboratory  by  analyzing 
deposits  made  in  a  settling  column  from  resuspended  bed  samples. 
Inspection  of  cores  and  laboratory  analyses  of  slices  from  the 
.■ores  can  provide  information  on  layering  of  virions  sediments. 
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1  i  .  Indirect  methods.  Indirect  estimates  o I  critical  shear 
stresses  tor  deposition  and  erosion  oi  cohesive  sediments  can  be 
made  be  neasurin;1  certain  parameters  and  comparing  then  with 
valors  obtained  by  laboratory  tests  on  similar  sediments. 
Measurements  ot  mineralogy,  cation  exchange  ratio,  and  sodium 
adsorption  ratio  can  be  used  to  characterize  the  sediments  and 
thus  the  critical  shear  stresses.  For  examples  see  Krone  (1972 
and  I97H)  anti  Ariathnrai  and  Arulanandan  (197K). 

17.  >  j  r  e  I- 1  methods.  ')i  rect  methods  ot  obtaining,  critical 

shear  stresses  involve  pen  nr  m  i  in;  l  I  une  tests  on  sediment  sam¬ 
ples,  then  calculatin'1,  the  critical  shear  stresses  Iron  test 
results.  These  tests  usually  require  lar.;o  sample  volumes,  spe¬ 
cialized  t  1  ernes  ,  or  both. 

11.  A  second  direct  method  uses  a  rot.it  inj;  cylinder  appara¬ 
tus  in  which  a  core  ot  sediment  is  placed.  Smaller  samples  can 
he  used,  but  the  method  may  require  remold  int;  ot  samples  and  does 
not  work  tor  very  loose,  I  resli  deposits. 

Direct  methods  for  obtain  inn  critical  shear  stresses 
are  i  a  i  r  1  y  i!i  I  l  icult  to  pe  r  1  or  ui  and  the  results  may  he  affected 
drastically  h y  seemingly  minor  test  procedures.  A  In  tier  way  is 
n  e  e  d  e  d  . 

1)  i  s  pe  rs  i  o  n _ coot  t  ij^i  e  n  t_s 

IS.  Ill  spi  l  s  ion  eoel  ticients  cannot  he  measured  directly. 

'1  it  e  y  are  a  '.unction  ol  i  low  characteristics,  the  vertical  s  e  d  i  - 
nent  concentration  protile,  and  the  computational  mesh. 

Deposit  iiin/i'  ro sion  patterns 

1  h .  be  po s  i  t  i on / e  r  os  i  on  patterns  and  vo 1 une  s  are  usually 
oh' .lined  !>v  eomparini’  successive  hydrographic  surveys.  The  re¬ 
sults  are  complicated  by  surveyinp,  errors  and  inaccuracies  (see 
paragraph  lb)  and  d  red,;  i  n;>  activities.  For  a  discussion  ot  some 
of  the  problems  involved  and  how  to  handle  then,  see  Letter  and 
Me  An  t  l  l  y  (,  I  "  7  7  a  ml  1  9  It  1  )  . 


1 

1  .  A  r « * .  i  s 

o  f 

cohesive  s  »•  <1 

i  Pit*  n  t  hi1  d  s  some  t  i 

ni  i' s 

ll  ii  V  4* 

thick 

l  .«> 

ITS 

•*1  very  1 

o  w 

de 

ii  s  i  t  y  d  e  po 

sits  on  th  e 

hid. 

Til 

r  St*  d 

C‘ 

po  sits 

»  r  <• 

o  t 

ton  f  r.nisi 

tory, 

occur  r  i  ni, 

d  u  r  i  n  •  pe r  i 

ids  (J 

1  l 

O  W  V  l' 

1 

or  i  t  v 

.1  Mil 

r  c 

suspend  i  it  >’ 

i 

1  V 

e  1  oc  i  l  i  <  s 

increase  ( s  u e h  a s 

t  i 

ll  .i  1  4' 

y 

r  l  t* 

!>»*  h 

.» v  i 

o  r  i  *i  i*o  i  s 

[  ,i 

l  .? 

Teas).  Low  density  :1c 

po «■  it 

j,  r 

. .  n  r .» 

1 1 

S  1  ‘ 

.iro 

us  t 

i c  son u d  i  m 

#* 

i  pne n *  t  o 

j>  r  o  v  i  d.  f  ,1  c  p  t 

i  i  m  ,i 

sur 

«*  ne  n  t 

t  it  a  t 

.1  r  v 

s  «* 

r  i  ,)  ii  .*»  1  v  (  s 

i'  V 

4*  r  <\ 

1  leet)  in 

error.  ‘  ;  r 

sue  !; 

r  .> 

n  ii  i  t  j 

* 

d  «■  n 

sinctric  survey 

s  m 

,»  V  hi'  11  1  4*  (i 

cd  . 

Id  .  A  p  pe  11  d 

i  x 

L 

ot  this  re 

purl  d  i  snisses  nr 

t  t.<» 

is  ot 

.1  n  .i 

1  yz 

i  n ;;  !i  y  d  r  o>. 

r  .$ 

i>  h  i 

4’  4l.it.!  1  o  r 

scour  .in  d  t 

ill  c 

ut.it  i 

o 

11  s  . 

K  1 


K  1  K  1.0  ! )  A  I  A 


0A/8S 


Table  K2 

Field  Data  Required  for  Hydrodynamic  Mod  els 


When 

I) a  t  a  K e qu  i  r c d  Needed  Used  f  or 


Obtained  I ron 


Water 

levels 


Always  B  C  ,  *  veritica-  Direct  measurement 
tion,  calcu¬ 
lation  of 
r  o  u  g  h  n  e  s  s 


Current 

velocity 

(discharge) 


Always  BC  and  veri-  Direct  measurement 

f  i  c  a  t  i  o  n 


Boundary 

roughness 


F.  d  d  y 

viscosity 


Always  Model  input 


Always  Model  input 


Observation  of  channel  forms 
and  vegetation.  Analysis 
of  water  levels  and 
discharges. 

Kstimated/calculated 
from  knowledge  of  flows 
and  mesh 


Wind  Sometimes  Wind  BC  and 

velocity  prototype 

understanding 

Climatic  Sometimes  prototype 


W.i  l  e  r 

temperature 


Always  Model  input 


Direct  measurement  or 
weather  records 


Direct  measurement  or 


understanding  weather  records 


Direct  measurement 


l.a  t  i  t  nd  e 


Always  Model  input 


*  BC  =  Boundary  conditions 


MKI.I)  !  >  A  T  A 
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Table  Kl 

Field  Data  Ke([ui  red  for  Sedimentation  Model 


When 

Data  R  e  quired  Needed  _ l’ s  e  d  F  o  r 


Obtained  From 


(.ram 
si  z  e  s 


A  1  ways  M  ode  1  i  n  p  u  t 
t  o  r 

n u  ti  c  olies  i  v  e 


Lab  measurements  oi 
sample s 


Settling,  Always  Mo  <1  e  1  i  n  p  u  t 

velocities 

Concentration  Always  B  C  ,  *  1C** 


lab  measurements  o I 
s  a  1 1 1>  I  o  s 

I  .a  b  ineasurei'it'ii  t  s  nt 


( sed iment 
supply) 

He  (I 

r  u  mi  li  n  e  y  s 


Hi- cl 

.1  e  n  s  i  t  y 

B  o  d  shear 
stron t  h 

Critical 
s  h  c  a  r 
st  n-ss 


ami  verification  samples 


Us  ii.i  1  1  y  Mori  el  In  pi.  t 


li  snail  y  Model  in  pu  t 
1  or  cohesive 

Usually  Model  input 
for  cohesive 

Always  Model  input 
tor  cohesive 


nbservnt  ion s  o t  c h anno  1 
torus  and  vegetation. 
Analysis  of  water  levels 
and  discharges  or  veloci 
p  r  o  ti  1  e  s 

l.a  I.  me  a  sur  emc-  n  t  o  I 
samples 

l.ab  measurement  and 
calculations 

Lab  measurement  aim 
calculations 


Bed 


Usually  Model  input 


consolidation  for  cohesive 
coef  f  I  fients 


Lab  measurement  and 
calculations 


B  e  d 

structure 

Water 

temperature/ 

density 


Always  Model  input 

Always  Model  input 


Analysis  o t  c o  r  e  s 


Direct  me  a  s  1 1  r  e  m  e  e  t.  / 
c  a  I  c  u  l  a  t  i  o  n 


Dispersion  Always  Model  input 

I'ut't  1  i  c  i  e  n  t  s 


Calculated  or  estimated 


)e  no s  i  t  i  ■  n /  Usually  Verification 

erosion 
patterns  a 
v  o 1  ume  s 


C.i  I  nil  at  rd  iron  m u  1  t  i  e  1 
h  y  cl  r  og  r  a  p  h  i  c  surveys 


*  *  i  c 


Bo  ii  n  d  a  r  ■  Conditions 
Initial  (.mill  i  t  i  ons 


0  .  /  R 


H  r.  t  k  !-. C  1.  S 


A  [  i  .1  t  i  u  r  -i  i  ,  c  .  ,  an.l  A  rnl.i".u;  i!  .m,  K  .  1  9  7  A  .  "Crosion  ka  tes  of 

•••-,  i  v  '.ills,"  AS  CL  lour  ia'  o  f  tl'  ■  y  d  r  a  u  1  i  r  s  division, 
i-  ■  1 1  ' .  a  r  v  , 

r  i  ■  a  1  k  '  r  1  ■/  ,  i,  .  “.  .  ,  I'.irriiin  ,  .1  .  W  .  ,  and  C  r  o  u  s  e  ,  1;  .  A  . 

At  •  •  i  •  i  i  -iy.i  P  i  v  e  r  :>•- ;  t .»  ,  pi*  port  2  ,  r  i  <•  1  d  Data,"  T<  c 

.  S.  A  r  r  v  •*;•»,;  i  nee  r  W.i  t  •  rwa  y  s  Kx  :>«•  r  i  me  n  t 
.1  .'.Mir  1  i  s  s  . 

-  r  >,  e  i  ,  .  k,  .  19  7/.  "A  r  i  e  1  d  St  n 

i  r.‘.  (  n.ir  i  .1  I  Shoal  t  i Processes," 

C 1.  • .  ii  i  t  t 1-  e  mi  I  i  d  a  1  Hydraulics,  L  . 

Y  i  c  r  s  n  u  r  ,  Miss. 

>’  t  nr  ,  k  .  H  .  19  7k.  "  A;',  ’  r  t  a  t  i  u  n  m  S  u  s  pe  n  d  d  I'  a  r  t  i  r  i  e  s  in 

!•.  s  t  1 1  a  r  i  i  ■  s  ,  "  in  estuarine  transport  processes  ,  H  .  )  n  ric  ,  ed  .  , 

1  1  !•  to .  liar  u  eh  Library  in  Marine  Sciences,  So.  7,  University 
S u  n  t  1 1  Carolina  Press,  Co  1  u n  n  i  a  ,  s  .  C.  . 

Letter,  I  .  V  .  ,  and  M  c  A  n  a  1  l  y  ,  ...  if: .  1-1/7  (Nov).  "  P  h  y  s  i  c  a  1 

II  yd  r  i  ii  1  i  r  Models:  As  s  s  s  n  e  n  t  o  !  predictive  Capabilities; 

II  o  v  a  S  I  e  -  lie  d  Model  ot  (.a  1  vs  t  on  Harbor  fit  ranm:  ,"  Research  Report 
II  -  /  -  5  ,  Report  l  ,  i  .  S.  Army  Kn.;ineer  Waterways  experiment 

Station,  Vicksburg,  Miss. 

Letter,  I  .  V  •  ,  and  Mt  An  a  1  1  y  ,  W  .  II  .  1  9  s  1  (Sep).  “Physical 

Hydraulic  Models:  Assessment  o  t  Predictive  Capabilities;  .Model 

Study  o  1  Shoal  i  in,  ,  Brunswick  Harbor,  (,»■  o  r  i  a  ,  "  Research  Report  ii 
7  S  —  i  ,  Report  1,  L  .  S.  Army  hnp.ineer  Waterways  experiment  Station 

V  i  r  k  shun;  ,  Miss. 

Parker,  W.  k  .  ,  and  Kirby,  P  .  19)',].  "Time  Dependent  Properties 

ot  Cohesive  Sediment  Relevant  to  Sedimentation  -  Kuropean 
experience,"  in  lstiiariiie  Comparisons,  l" .  S,  Kennedy,  Kd  .  , 
Academic  Press,  New  York. 

I  s  t ;  s .  19  7  7.  "National  Handbook  o I  Recommended  Methods  for  W  a  t  e 

Lata  Ac  <|  ii  i  s  i  t  i  o  n  ,  ”  r  .  S  .  Department  o  I  the  Interior,  tie  o  1  o  i  c  a  1 

Survey,  Re  s  t  o  n  ,  V  i  r  ",  i  n  i  a  . 
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ADDhNDl  .1  K  1  :  SOURCES  Or  K  I  ELI)  DATA 

l'.  S.  Geological  Survey 
rti'ston  ,  V A  2  2  0  4  2 

and  District  m  f ices 

1'.  S.  \rny  Corps  o:  Engineers  (district  offices) 

1'  .  S  .  K  i  s  ii  a  nd  Wildlife  Service  (district  .it  l  ires  ) 


l! .  S.  Bureau  of  Re  c  1  am.)  t  i  on  (local  offices) 


National  Ocean  Survey 

National  Oceanic  and  Atmospheric  Administration 
Rockville,  MU 

Environmental  Protection  Agency  (regional  offices) 


State  organizations  similar  to  Geological  Survey  and  F  >  s  h  a  nil 
Wildlife  Service 

Soil  Conservation  Service  (district  offices) 

In  i  vers i t  i e  s 


API’ KM)  IX  L:  DAT  A  MAN  AG  KM  K  NT  SYSTtiM  A 

GoNTKNTS 


P  a c 


I'AK'I  I:  IMROI.'UCT  1  ON . 1.1 

P  1 1  r  |  m  >  s  o . .  . . 1,1 

Data  liasi1  Mail  a  p,  e  m  o  n  t . 1.1 

WhS  I )  ;'■!  S  —  A  .  . . 1.2 


PART  11:  PROGRAMS  AM)  P  R  O  C  K  I )  I  K  K  S . I.  > 


Data  I’U’parat  ion . I.  a 

Data  Pruci'SS  i  n  ; . IS 


1 1 ,i  t  a  Ri' t  r  i  i’va  I  a  n  <1  I)  i  s  n  1  a  y . 

PART  III:  TV  P  I  CM.  APPI.  1  CAT  1  ON'S . 

A  rl  d  i  n  n  K  litvat  inns  to  G  F  G  I-.  N  Input  Kile . 

Post  Con str action  Ver  i  t  i cat  i  . . 

S  e  il  i  m  e  n  t  Model  Vtr  i  I  i  cation . 

At  clint  a  lay  a  bay  deltaic  Growth  extrapolation 

ADPKNDA:  Pro:;rnn  Descriptions  and  User  Instructions 


I)  i  g  i  t  1  7.  i  n j;  Prn^r  am s 

I. -  l  .  1 1 : i s  i >  1 1: . i-l-l 

1.-2.  DGPl.T . I. -2-1 

Foma  t  i  n ;;  Pro p  r a n s 

I.-T.  K  K  Ml . h-T- 1 

1.-4.  1KANSA . L-4-1 

1,-S.  K02  V ' . I.-S-1 

I.'  N  2  F  ( ) . 1  - 1>-  1 

Grid  Transform a t  ions 

1,-7.  MI'.SPI  . 1,-7-  1 

l.-H.  'IKS  il  2 . l.-'J-l 

I,-).  ‘IF.  SI!  3 . 1 

1.-10.  KI.I-.V’GItP. . 1,-  in- 

1,-  1  1  .  K  P  T  i’  v  T . 1-11- 

1.-  I  I .  K  A ( , ( i  K  1 1 . I.-  1  2- 

1)  a  t  a  1  r  a  n  s  I  o  r  pa  t  i  o n  s 

I.-!').  GKDSCrt . !  -  13- 

1.-14.  HTIIAKKA . 1-14- 

I,-  1  S  .  HAT II  Vo | . I.-  1  s- 

o.i  t  a  K  c  v  i  e  v: 

I.-  I  n  .  HP-  PI.  P  2 . V-  1  <>- 


1.  1  " 

1.1  a 
I.  1  n 
1  I  I 

1.1  1 


DATA  MANAGF.MF.NT 


A  P  I'  r. I)  I  X  I.  :  HA  I  A  ■  I  A  .>  A  (.  K  M  K  NT  SYSTliM  A 


1’  A  II  T  I:  I  I  KC  1)1!  CT  !  0  S’ 


l*n  r  |io  ho 

I.  The  purpose  m  this  appendix  is  to  describe  t  tic  Water¬ 
ways  ■  i>cr  !  nriit  Station  (wKS)  Data  Innaiji’ni'nt  System  A  (  1 '  i  i  S  —  A  ) 
ami  a  jimvi  le  a  riannal  fur  the  systi’n's  use. 

’ .  fin'  primary  o  h  j  e  <:  t  i  v  e  s  oi  the  UMS-A  are  to  provide 
lor  .irn.r.iti',  i.  i  I  ••  c  t .  i  v  c  ,  and  rapid  access  o  I  spatially  d  i  s  t  r  i  h- 
utel  data  Lot  use  in  hydraulic  studies  oi  rivers,  lakes, 
estuaries,  and  coastal  waters. 

Data  Base  Management 

J.  A  data  base  consists  oi  a  collection  oi  information 

stored  f  u  a  sys  t  e  in  a  tic  t  a  s  h  i  o  n .  1  n  earl  y  computer  a  n  p  1  i  c  a  t  ions, 

nos!  da’.i  bases  ;,i  rr  loosely  organized  and  dependent  on  the 
programs  that  accessed  them.  A;  data  liases  ",rew  larger,  two 

needs  arose - stora;;e  schemes  that  permitted  rapid  access  to  the 

data  and  access  methods  that  allowed  more  than  one  program  to 


U  S  P 

o  a  t  . 

;t  1 

r  o  ; 

•1  l. 

hi 

*  •> 

a  sc.  K 

r  n  m 

l  i  i  e  s  e 

n  i*  p 

d 

S  l*  v  o 

1  V  p 

d 

m  o  d 

e 

r  u  da  t  a 

b  a  s  e 

in  ci  n 

,  . »  •;  e  n 

p  p 

l  s 

ys  t 

P 

n  s 

(Pv.  MS)  wh 

i  0  li  ex 

:  i  h  i  l 

: 

the  1  ■ 

o  1  1 

o 

w  i  ns; 

c  ! ,  a 

r  a  c  t  < 

*  r  i 

S  l  i 

i  r  s 

<1  . 

(  T 

a 

t  a 

at'  ?■ 

?  C.  o  r 

p  <!  ;  n  a 

i  s  y  s 

l 

n  a  t 

i  c  : 

i  s  li  i 

o 

n  that; 

pi 

i  n 

i  n  i  x.t’f 

■;  r  e 

d  u  n  d  a 

n  c  y 

yet  III  a 

k  i  i 

m 

i  /.  e  s 

s 

p  e  e  d  o  i 

I 

I  nc  a  i 

[  i  o»i  , 

ret  r 

i  p  v  a 

1 1 

,  and 

i  • 

i , 

'll!  i  1 

i 

cat  i o  n  . 

h. 

:  i 

t  h 

i  iio-ri 

t  i  n 

e  a  i  e 

•;  o  r  i 

< 

s  ,  l  1:  l 

s 

L 

r  nc  t 

u 

re  tilth 

(' 

d. 

1 1  i\ 

s  t  o  r 

i  ;  i  •  l 

s  t  hi 

s  a  pi  i 

•  t  o  r 

a  1  1 

i 

d  a  t  ;i 

i 

t  y  p  o  s  • 

r  < 

.  1 

'  A 

r  \ 

n  a  y  ’> 

i  .id 

il  e  il  ,  d 

e  I  e 

t 

i’d  ,  or 

c 

li 

a  n  v;  p 

•i 

with o  u  t 

r « 

•  r  r 

e  .  1  l  i  11: 

the 

■  rnti 

r  p  < 

1.1 

i  t  a  ha 

s  c « 

d . 

T 

h » 

■  p 

r  o  V,  r  a 

n  t 

h  a  t  s 

tori 

and  r 

rl  1 

i 

e  v  ■  :• 

t 

h  c  ti  a  t  a 

a  r  r 

■  pa 

r  a  t  e  t 

r  o  m 

t  ho  se 

that 

ana  1 

y  z  c 

or  (’ 

i 

splay  t  h 

r  da 

A  • 

A  c 

o  p 

pi 

4'  t 

e  t  uni 

vers 

a  1  l  y 

app  1 

i 

cable 

I'li 

*1 

S  i  s 

not  olt e 

n 

» i  •;  r 

(>  si  r 

i  re 

n  t 

.  S  t. 

i 

is  r 

S  .M.’ 

SO  S 

;it  r  i  a 

l  i  z  r 

.* 

that 

l*  . ! 

r 

r  v  i  n 

\\ 

a  1  I  t  1 1 

( 

i  a  p 

anil  1 

t  i 

•  ‘  s 

<)  1 

1  11 

n  i  v  p  r  ; 

.  it  s 

*■  t  e  in 

hr  c 

o 

i:i  e  s  1 1 

Mill1 

r 

r  s  s  a 

r 

i  1  y  e  x  p  e 

a  ~ 

s  i  v 

C.  ill 

t  • 

(n  r 

i  S 

■  > 

K  n  ",  i  ih 

r  s 

nSrs  : 

s  r  v  p 

r 

a  1  , 1  H 

'1  s , 

sti  rl: 

is  'If! 

(Sc 

i  r  n  t  i 

r  i 

c  1 

•\  ;  i 

)  r 

r»  a 

t  i  on  i 

at  i  i 

c  v  a  1  ) 

and 

SYSTI  : 

'1  2 

,i 

mostly  1  o 

r 

use  will  I  i  !■  I  -1  m  e  a  s  i:  r  e  n  e  n  t  s  . 


lor 


s  ins -a 


a.  I'm  DMS-A  systcn  is  use!  hy  tin-  Hydraulic  Analysis 
and  K  s  t  ii  a  r  i  s  Divisions  of  the  KKS  Hydrati  l  ics  Laboratory.  The 
basic  PIS-A  :ilf  structure'  and  several  of  the  DdS-A  programs 
were  developed  under  the  supervision  of  l)r.  Victor  LaCarde, 
o  »  the  t. f  s  Knvi ronroenta  l  Laboratory  .  Tne  hMS-.A  system  is  a 
sube  1  etnent  of  t  lie  TABS-2  data  management  system,  which  also 
includes  the  Colunhta  River  hybrid  modeling  system,  the  TAHS- 
t  i  1  e  nan.i  ;  e  "I  e  nt  systen,  and  various  utility  pro  g  r  a  m  s  ,  funds  t 
orivt'i'  [  t  h  e  system  to  nino  r  i  e  a  I  m  o  .1  e  1  i  n  g  applications  uetc  pro¬ 
vided  by  the  V  S  Amy  Engineer  District,  New  Orleans. 

h  .  T  h  e  t  h  r  *'  e  major  e  o  n  p  n  t  e  r  sites  lor  DMS-A  art'  the 
„  f s  iio  !!••  y  we  |  ;  lipS-f'  (WHS),  the  CYHEkUT  computer  system,  acl’l 
tile  1  s  Environmental  laboratory's  Prime  m  i  n  i  c  o  r  n  t  <■  r  .  Not 
a  I  l  ot  the  "tost  ci  r  r  e  n  t  versions  of  the  codes  are  running  at 
these  sites,  but  they  are  installed  on  any  computer  system 

as  needed. 

7 .  The  DM S -A  consists  o I 

a  .  Manual  data  Ii  a  n  1  l  i  n  g  p  r  o  c  e  d  u  r  e  s 

n  .  ifr  itltl  i  ni;  and  grid  trunsi  orw  t.  ion  pro  '.rams 

c.  Program  modules  to  acc«  npl  Ish  f  l  y  execute-.', 

n  a  n  i  ;hi  I  a  t  i  on  ant!  display  tusns. 

Item  c  atx)  e  iucl  odes  Rune  tasks  that  an-  nut  usually  con  si  dt  red 
part  of  a  data  base  management  system.  They  are  included  be  cans 
t  hey  are  almost  universally  a  p  p  I  i  c  a  b  1  e  t  a  spatially  i.  is  t  ri  luilit. 
i!  ,i  t  a  . 

C  h  a  r  a  c  t e  r  nl  the  Data 

H.  The  DMS-A  is  designed  principally  lor  use  with 
spatially  !  i  s  t  r  i  but  m!  data,  which  consists  m  a  set  of  lot*  it  ion 
coord  i  nut  es  plus  a  set  o  I  parameters  assoc  i  at  ed  will.  each 
locution  u  a  pa  r  t  i  c  u  J  a  r  t  i  c,  .  '1  e  ,,  o  r  a  t  1  y  d  i  s  f  r  i  ’>  n  t  e  ■  d  a  t  a  c  o  n  - 

wist  of  a  s.-ries  ill  pu  r  ;t  me  t  e  r  s  ..  <  they  t  ,i  r  y  in  •  i  o.  at  a  ■,  i  v  <■  r 

location.  Nearly  all  d  a  t  a  u  s  e  tl  in  hydraulic  studies  consist 
essentially  of  a  set  m  s  p  a  c  e  -  t  i  m  e  ronr.!  i  not  rs  plus  ;  a  t  a  i  ■  1 1  r  •> 
assoc  i  at  ed  with  the  coordinates.  1  ii  e  oa  tore  of  data  and  analyses 

commonly  used  in  hydraulic  s  t u  d  i  s  r.s;u  ins  that  both  spat  i  a  i  I  v 
ii  i  *.  t  r  I  I'll  ti  i;  .iii.i  temporally  t  i  s  t  r  i  b  Ii  t  e  d  I  o  r  s.  a  l  s  he  .  i  .■  ■  i  i  1  a  b  1  ■  ■ . 

A  1  t  :  n  n  p,  h  P  :  s  -  \  I  ••  ,  i  s  <  J  for  data  t  i>  a  l  are  primarily  sp.it  i  illy 

distributed,  time  variations  can  be  In  at  ed  within  tne  system. 

h .  S  p  a  t  i  a  II  v  distributed  data  occur  in  two  terms  — 

e  n  n  t  i  1 1  a  e  1 1  s  a  ■  \ .  I  t  .,  e  t  o  r  .  boot  inooiP  1  .  v  a  r  ;  in1,  Pit  i  r  .  s  i  n  s 

, .  *  v  i  r  i  a  i  1  ■  t  i,i  '  ran  take  on  a  n  v  s  c  a  I  a  I*  v  a  i  n  •  ■  i  r  ■  .  e  >  a  ’  ;  "  •  i  "  *  ‘ 

r  ii  .  r  .  a  i  ril'ii  s,  I  ' . .  v  a  r  i  a  Ii  1  e  chan  s  .'..ol  i  iiimn  \  u  ■  .  r  t  • 

spue  in1  i  n  s  a  n  '  I  e  1 1  ,  s  1 1  c  1 1  is  '  a  I  .  v  . ,  t  i  o  n  s  o  !  a  v  a  t  e  r  ■  '  1  y  . 
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Factor  n.it.  i  have  diserete  values  that  are  Keyed  to  a  particular 
state  or  classification.  "nr -a  ally,  factor  data  will  have  a 
constant  value  over  a  closed  area,  such  as  bed  sediment  classifi¬ 
cation  ( g  r  a  v e  l  ,  sand,  silt,  or  clay). 

I  1  • .  Hydraulic  data  are  generally  derived  from  tour  sources- 
i  i  e  I  d  measurements,  physical  modi1  l  measure  men  t  s  ,  numerical  mode) 
output,  and  results  of  data  analyses.  The  following  list 
classifies  the  data  mist  frequently  encountered  in  hydraulic 
studies: 


d  yd  r  a  u  1  i  c 

(1)  durrent  speed  and  direction 
(  ’ )  Surface  elevations  and  stages 
(  t  )  Disc  ha  rgo 

(a)  Tidal  constituents  (amplitude  and  phase) 

(5)  Hydraulic  roughness  parameters  (Manning's  n,  etc.) 


Me  t  eoro 1 o  ;  i ca 1 

(!)  wind  speed  and  direction 

(2)  harometrie  pressure 

(T)  Air  and  water  temperature 
(A)  Precipitation 

Sediment 

(  I  ;  Suspended  sediment  concentration  and  character  — 
'•.rain  sizes,  mineralogy,  etc. 

(  )  Fed  material  characteristics  —  color,  density, 

'.train  —  size  parameters,  mineralogy,  etc. 

(  i  )  Sediment  d  i  s  c  I  a  r  ,,e 

Wave  Innir  lilt  i>m 

(I)  Wave  hei  ;  li  t  an1  per  iod/ 1 engt h 
( 1 )  lave  d i r e  c  t i on 
( 1 )  Spectral  distribution 
(  A  )  i  >»•  l>  i  t  a  1  velocities  and  amplitudes 

!v:l  ter  qti.i  I  i  t  y 

(  l  )  Salinity 

(  )  h'lqiiTii!  nri 

(  ’  ;  .it  he  r  wafer  quality  parameters 
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f  . 

R  a  t 

1 1  y  m  e  t  r  y 

(  i  ) 

Water  cf  c  |>  L  J«  s  /  hu  ri  f*  lcv;iL  tons 

( ■;) 

l>oci  o  K* vat  ion  Hiairu's 

li* 

Go  one t  r  y 

(  1  ) 

(lonjm  1.  at  i  ona  1  nosh  no  i  nt  locations  am* 

11  0(1 

n  urn  be r  s  • 

(2) 

1*  •  s  h  .',com»»try  specifications  (  o  1  op  n  t 
connections,  o L  c  • )  . 

(  1) 

As  s  i  p,  notl  or  confute*!  mesh  p  a  r  a  no  t  *•  r  s  ( 
viscosity,  nlriont  area,  etc.) 

!■'  u  n  d  a  ni  e  ntal  d  a  t  a  structur  e 


11.  When  C  1 1  <  •  K  !'.  S  1)  (1  S  -  A  was  written,  computer  li  m  i  t  a  t  i  o  i)  s  an 
storage  size  and  speed  mailt’  1  ti  r  > ,  <  ■  numbers  of  floating  point 
a  r  i  t  hine  t  r  i  c  operations  impractical.  Therefore  the  WES  1  i  r  l  S  —  A  was 
written  to  utilize  integers  lor  many  of  tlie  system's  calcula- 
t  i  on  s .  When  process  i  im;  data  lor  which  decimal  l  r<H‘t  ions  ore 
used,  the  data  a  r  e  m  u  1  t  i  p  I  i  e  <l  b  y  a  n  a  p  p.  r  o  p  i  a  t  e  po  w  e  r  o  1  in  prior 
to  processing  and  divided  by  the  same  factor  after  proces¬ 
sing,  a L Lowing  the  user  control  over  the  precision  ol  the 
integer  conput.it  io  ti  s  . 
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12.  The  proei'duros  typically  involved  in  a  study  are 
discussed  in  t  I;  i  s  part  of  the  appendix.  The  programs  normally 
utilized  in  these  procedures  are  mentioned  and  are  also  listed  i 
Tulle  I  1  along  with  a  hriel  description  of  their  function. 


Data  Preparation 


!">.  ').!  t  .1  which  are  to  he  initially  placed  in  the 

system  are  usual  ly  in  graphical  form  such  as  maps.  Those 
data  are  manually  digitized  and  thereafter  the  only  manual 
procedures  perl  or  mod  are  error  checking  and  edit  in;;. 

I  .  \  rectangular  coordinate  system  is  imposed  on  the 

lata,  usually  either  the  Universal  Transverse  Mercator  (UTM) 
state  planar,  or  an  arbitrary  rectangular  system.  Unless  the 
area  of  interest  is  very  small  or  very  large,  t he  stale  planar 
system  is  used. 

11  i »;  i  t  i  /.  i  igg 

11.  The  t  i  r  s  t  slop  in  the  <1  i ;;  i  t  i  z  i  n  g  process  is  to  posi¬ 
tion  the  map  on  the  digitizer  tablet  with  the  rectangular 
coordinate  system  of  the  map  parallel  to  the  x-axis  (lower 
horizontal  limit)  of  the;  digitizer.  The  DflS-A  programs  will 
make  correct  ions  lor  distortions  in  the  map's  rectangular  coordi 
n.ili-  system. 


16.  The  digitizer  at  the  l-'I.S  Instrumentation  Ser¬ 
vices  Division  (IS;))  is  configured  to  wriLe  recor<!s  containing 
twe  integer  Hells  o  1  six  digits.  Kor  this  reason,  the  DM  S  -  A 
programs  read  d i , i t i zer  data  in  a  FORTRAN  216  tormat.  Program 
DMSDIw  has  hisei  developed  to  control  Tektronix  di ;itizers  and  it 
also  writes  the  216  format.  A  11 M  S-  A  digitizer  tile  consists  o  t 
an  identifying  record,  ix  records  containing  transformation 
ini ormat ion,  area  o  t  interest  definition  to  limit  computations 
to  a  specific  area  ol  the  grid  (it  needed) ,  and  records  con¬ 
taining  the  needed  input — elevations,  depths,  coordinates,  etc., 
for  the  particular  DMS-A  program.  Special  flags  are  included  in 
this  lile  to  ensure  that  the  correct  program  reads  the  tile,  an 
that  data  mismatches  such  as  comparing  depths  and  elevations  do 


tor  u  s  i  n 


not  occur.  Instructions  lor  using  the 
T  e  k  tronix  t<  914  digitizer  are  given  in 
Instructions.  Table  1.2  illustrates  t  li 
record  types  a  t  a  digitized  data  lile. 
depending  on  the  type  of  data. 


sing  the  IS'-)  digitizer  and  t  he 
i  v  e  n  in  AIM’  KN  D  I  x  I-  :  Digitizing 
rates  the  tormat  n I  the  l  i  r  s  t  ten 
t  a  lile.  Records  I  I  -  I  4  vary 


17.  \  d  i  g  i  t  i  ze  r  tile  tormat  has  he e n  d e v  e  1  o pe  d  to 

in  a  kc  d  i  g  i  t  i  z  i  ii luster  and  to  allow  tor  better  error  correct!  o  n 
This  new  tile  I  o  r  i  a  t  type  most  be  lead  I  h  r  o  n  ;  h  I' :  u.g.in  " !'  S  Ml  to 


DATA  MANAt.KM"’  T 


04/85 


check  Clio  data  ,nul  convert  it  be  be  read  by  i.I.i.VGH1.  Digitizer 

input  tile  tor  it  K  K  T  IT  t»l  lows  the  2  T  f>  i  urmst. 

IK.  The  area  of  interest  specification  allows  t  l  a>;  i  n ;; 
portions  of  a  m  a  p  where  nonexistent  or  bn  d  data  exist.  It  also 

can  be  used  to  1  in  i  t  nridd  in:;  computations  across  islands, 

jet  tvs,  levees,  and  dikes.  The  area  ot  interest  is  del  i nod  by  a 
series  o  t  points  that  enclose  the  region  o  I  the  map  for  w  h  i  c  ti 
data  is  presented.  The  points  are  digitized  in  a  clockwise 
direction  around  the  area.  if  a  1  a  r ",  e  nun  tier  ot  maps  (e.;., 
various  ites)  lor  a  >;  i  v  e  n  project  are  digitized,  the  precise 
area  o  t  interest  tor  each  map  w  i  !  i  nt  ten  n.  .1  i  l  it  rent  because  o  I 
d  i  t  t  .  ■  r  e  ii  c  e  s  in  local  ini;  the  suci'csted  urea. 

19.  A  set  of  prop, rams  called  MESH  merges  difteront  input 
digitizer  tiles  that  have  been  developed  separately.  MKSlil 

m  e  re.es  scalar  data  that  is  in  tabular  torn  i  d  e  n  t  i  t  i  e  d  by  ;t  s  t  a  - 

linn  number  to  a  set  of  x  -  v  1  o  cations  c  n  r  r  e  s  po  n  d  i  n  ■ ,  t  o  m  a  it  e  a 

complete  digitizer  file.  tl  b  S II  1  is  o  l  t  e  i.  used  with  sediment 
n e a s u r e ne n t s .  MKSH 2  is  designed  to  work  with  standard 
hydrographic  survey  data  (strings  of  soundings).  MliSII'l  reads  in 
data  sets  generated  irom  multiple  mans  ot  subareas  to  a  master 
set  for  the  entire  area  of  interest. 

Overlays 

20 .  When  repetitive  d  i  i;  i  t  i  z  i  n  e,  is  to  be  performed  lor 
tli"  same  basic  nap  cover  a  >;  e  at  a  v  i  v  e  u  scale,  the  usi  of  over¬ 
lays  is  r  e  com  ne -idl'd.  In  order  to  simplify  data  processing 

at  later  stapes,  it  is  necessary  to  have  consistent  corner  coor¬ 
dinates  tor  each  of  the  series  of  maps  to  be  digitized.  for 
this  purpose,  overlays  can  he  constructed  on  transparent  film 
which  has  the  four  map  corner  coordinates  tor  the  series  ot 
maps  and  the  line  segments  connectin';  the  corners.  It  is 
also  recometwled  that  internal  control  points  he  included  when¬ 
ever  maps  of  variable  coverage  and  orientation  are  to  be  digi¬ 
tized  tor  the  same  project  location.  The  control  points  can  be 
checked  tor  consistency  to  reduce  t  tie  chance  of  undetected  errors 
in  t  i  t  t  i  n i;  t  la  overlay. 

<}  ua  I  i  tv  control 

2  1.  h  .i  c  h  of  ttie  p  r  ot;  r  a  m  s  i  n  the  I)  ’t  S  -  A  contains  quality 
control  procedures,  primarily  those  t  ha  t  check  il  a  t  a  v  a  1  m-s  t.  o 
see  it  they  tall  with  i  n  re  a  s  o  n  a  b  l  e  bo  on  d  .  ()u  alii  y  e  out  r  o  1 

programs  display  t  lie  d  a  t  a  r  a  p  b  i  c  a  l  1  v  to  permit  i  n  s  p. .  c  t  i  o  n  .  I'ro- 
r  l  m  1  Xt  P  I  T  c li  e  c  k  s  digitized  data  ioim.it  and  plot'  the  area  o  ! 
interest,  the  tour  corner  c  no  r  'I  i  n  a  t  e  s  and  nnnu-ct  iu;  s  e  >,  r>.  nts 
for  use  with  overlays,  and  the  digitized  I  o  c  a  t  i  o  -t  c  no  r  d  i  p  a  t  e  s 
o  t  the  raw  d  a t  a . 

(i  r  i  tl  tl  i  n  ,<  a  n  d  t;  rid  t  runs  I' or  m  at  ion 

2  2.  Sil.it  i  .1  1  I  V  d  i  s  t  r  i  I  'I  t  e  (I  e  a  t  a  usn.il  I  v  are  ■  r  i  a  M  e  d  ,  L  h  .i  t 
is,  values  arc  s  1  . .  r  e  tl  lnr  even  increments  o  I  distance  a  1  u  n  . ,  tie 

I  «. 
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“  -  .iiiO  y-.ixrs  ni  ;m  i)  r  L  i  oro  na  1  niurHii.iLc  systi-m.  Raw 
results  .ire  ol  ten  ungridded,  but  intermediate  results 


i  -Shi  us  .ite  iil  l*ii  iiii^i  luiieu,  diil  i  nier  men  1  ate  results  are 
usually  in  ■;  ridded  torn.  Output  is  always  a  ridded  unless  the 
spec  it  ic  application  requires  u  u  R  r i d  d  e  d  data. 

2  3.  (.‘ridded  data  are  often  assigned  to  cells  rather 
than  points.  Data  cells  are  identified  by  their  size  (dx  and 
dy),  location  (x  and  y),  and  cell  index  (i,j)  where  cell  (1,1) 
is  Lite  upper  left  corner  of  the  ijrid.  In  DMS-A,  all  Rridded 

data  are  written  in  a  specific  binary  format  for  fast  access 
and  smaller  slnraijc,  except  tor  the  Honeywell  version  that 
has  some  coded  records  at  the  top  of  tlic  tile.  The  tormat  of  a 
D:tS-A  .'.ridded  data  tile  (output  from  Kl.CVGRD)  is  as  shown  in 
Table  1,3.  Since  DMS-A  tiles  are  in  binary  form,  data  written  in 
this  format  need  to  be  converted  to  a  coded  torm  (ASCII,  BCD, 
KBCDIC,  etc.;  lor  transler  between  computer  sites  or  between 
naiit  frames  o  I  i!  i  1  l  erect  manufacture  at  the  same  computer  site. 
Proq  ram  U ;;  >  y  o  converts  the  DMS-A  binary  format  tor  transler 
and  program  r02l>N  converts  the  coded  data  back  to  the  standard 
binary  tormat  after  transfer.  It  is  recommended  that  all  compu¬ 
tations  performed  on  a  particular  DMS-A  g  rid  be  done  on  the 
same  computer. 


tat  ions 


l  i .  Proq  ran  K  I.KVGRD  transforms  spatially  random  data 
points  into  uniformly  qrideed  data.  Interpolation  to  a  grid 
location  is  performed  by  a  I i ve-step  process: 

a.  the  nearest  input  data  points  are  located. 

b.  The  slope  of  the  variable  surface  is  computed 

at  the  location. 

c .  A  local  Cartesian  coordinate  system  is  placed 

with  thour  i  g  i  n  a  t  t  h  e  g  r  i  d  1  o  c  a  t  i  o  n  a  n  d  local 
y-axis  in  the  direction  ot  the  maximum  rate  of  change 

d  .  I h  e  n e  a  r  e  s  t i n  p  u t  data  point  in  each  quadrant  o  t  t  h  e 
local  coordinate  system  is  located. 

e.  The  it  r  i  d  -  I  oc  a  l  i  on  value  is  calculated  using: 


”  «l  (  i  )  2 


=  1  d (  i  ) 


r<*K 


7.  (  v;  )  =  <1  a  t  a  value  .it  t  h  e  r  i  r!  location 

Z  (  i  )  =  input  >)  a  t  a  point  in  the  i  t  ^  rl  (Irani  of  local 
c  o  o  r  <1  i  n  a  t  e  syst  e  in 
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d  (  i  )  =  distance  between  the  grid  location  anil  the 

closest  input  data  point  in  the  it*'  quadrant 

25.  Program  TRANSA  transforms  gridded  data  from  a  coded 
format  to  the  DMS-A  standard  format. 

26.  Program  KACGRD  reads  digitizer  files  of  data 
defining  area  of  constant  factors  and  grids  them,  writing  a 
standard  I)  K  S  -  A  formatted  file. 

27.  TABS-2  numerical  model  results  may  he  converted  to  a 
DMS-A  grid  hy  using  CONTOUR,  which  will  read  output  iron 
GFGEN,  RMA-2V,  KMA-4,  and  STUD!I.  Computed  model  results  such 
as  depth,  bed  elevation,  water-surface  elevation,  velocity 
magnitude,  water  quality  concentration,  sediment  concentra¬ 
tion,  and  bed  changes  may  be  g ridded  by  CONTOUR.  Program  CON TUCK 
is  described  in  A  I’  PR  NO  IX  T:  Graphics. 

Data  re v i e  w s 

2  2.  A  I)  M  S  -  A  g  r  i  d  d  e  d  il  a  t  a  file  m  a  y  f  e  lumped  to  a  line 
printer  using  p  r  o  g  r  a  in  li  U  M  P  K  R  2  .  This  dump  is  in  the  form  o  1  132 
column  wide  vertical  swaths  through  the  grid.  Both  I.  IX.  VC  10  and 
CONTOUR  uiLl  also  produce  DM  S-A  swath  dumps.  Grids  may 
also  ho  checked  graphically  using  contour  plots  (from  CON¬ 
TOUR)  or  using  3 -d i me  ns i on  a L  line  plots  (from  4VIKW).  Programs 
CONTOUR  and  4VIKW  are  described  in  APPP.NDIX  l:  Graphics 
Displays. 

Data  Pro ccssin g 

29.  The  UMS  assumes  that  most  users  will  provide  their 
own  programs  foi  analyzing,  data,  but  some  procedures  are  so 
commonly  used  that  they  have  been  included  in  the  DMS-A. 

30.  Program  CKDS11B  leads  two  sets  of  gridded  data 
and  calculates  the  difference  between  them,  producing  a  new 
gridded  data  set  that  represents  the  change  between  the  input 
sets.  It  is  commonly  used  to  calculate  depth  changes  between 
two  hydrographic  surveys. 

31.  Program  BTHAPKA  computes  the  area  between  selected 
contours  in  bathymetric  or  topographic  data.  It  is  commonly 
used  to  determine  the  distribution  of  water  depths  and  average 
depth  or  elevation  ovei  an  area.  A  companion  program,  HATUVOl,, 
computes  the  integral  of  the  differences  between  two  gridded 
data  sets.  It  is  commonly  used  to  compute  ttie  shoaling 
volume  between  two  hydrographic  surveys.  noth  BT'IAREA  and 
BATHVOL  can  use  FACCRD’s  output  to  produce  area  and  volume 
reports  by  sub-areas  or  patches. 


l.K 
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0  4/  8  r> 


8  2.  !)  ;i  t  <i  values  at  selected  points  within  a  l)  M  S  -  A  g  i  i  d.  m  a  y 
in-  obtained  usin;;  RKTPNT.  Input  to  KKTPNT  is  either  a  digitizer 
l  i  le  or  the  input  tile  for  program  GFC.KN.  Program  GFGF.N,  which 
generates  ,*,  eo  me  t  r  y  tiles  tor  the  TABS-2  models,  is  described  in 
APPK.NDIX  i  J :  Network  Generation. 


Data  Retrieval  and  Display 


33.  The  data  retrieval  system  used  for  interfacing  with 
the  DIS-A  in  the  WKS  Hydraulics  I.aboratory  is  accomplished 
by  m-aiis  ot  the  TArtS-2  tile  management  system  (FMS).  The  FMS  is 
host  conputer  site-speci lie,  and  this  appendix  will  only 
address  the  manipulation  of  tiles  once  accessed.  It  should  he 
emphasized  that  an  important  component  oi  any  eftieient  OHMS 
is  a  reliable  file  management  system.  The  KM S  is  discussed  in 
API’ K  Ml  IX  ,\ :  Fi  les  and  Ki  le  Management  System. 

34.  Programs  used  to  display  spatially  distributed 
data  product*  tabular  listings,  printer  plots,  and  output  from 
CRT  and  pen  plotters.  Program  DGPhT  may  be  used  to  graphical¬ 
ly  display  the  map  corners,  area  of  interest,  and  the  data 
point  locations  I  run  an  Kl.hVGRD  digitizer  input  file.  DUMPKK2 
prints  g  r  i  d  d  e  <1  data  in  tabular  t  o  r  m  such  that  the  data  can  he 
inspected  or  contoured  hy  hand.  Program  4  V 1 K  W  ,  mentioned 
(■artier  as  a  quality  control  device,  is  also  used  to  produce 
3-d i mens i on a  1  plots  of  surfaces  over  the  x-y  grid  lines.  The 
program  creates  tour  plots  with  viewpoints  from  the  four 
axis  locations  so  that  tour  ditterent  views  are  presented. 


(r). 

I1  r  o  g  r  a  m 

CONTOUR 

produces  contour  plots 

on  «- 

i  2-D 

c  oo  r d i na  t  e 

system 

t  run  a 

D  M  S - A  grid. 

bb 
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PART  III.  TYPICAL  APPLICATIONS 


Adding  Rod  Klovation  to  GKCE  N  Input  Kilos 

'16.  Automatic  numerical  nicsli  generators,  such  ns 
A  II  TO  M  S  If  ,  do  not  use  the  x  -  y  locations  o  I  t  h  <*  i  r  elements  and 
nodal  points.  This  limitation  is  necessary  to  allow  the  mesh 
smoothing  schemes  to  he  I  1  ex i hie.  Also,  tin1  user  is  more  tree 
to  experiment  with  various  mesh  configurations,  and  different 
hod  geometries  tor  a  given  mesh  can  he  easily  installed. 

17.  The  sources  for  digitized  data  may  he  Corps  of 
engineers  condition  surveys,  (JSCS  quadrangle  sheets,  and/or  N'OS 
navigation  charts.  If  more  than  one  source  is  used,  the  separate 
digitizer  files  need  to  he  combined  using  "KSHI.  'I  lie  master 
digitizer  file  is  then  converted  to  ilMS-A  gridded  format  using, 
KLKVGRi).  The  CKGKN  file  is  then  processed  hy  UKTPNT  to  obtain 
interpolated  nodal  values  from  the  DMS-A  grid. 

3b.  The  above  method  was  used  in  a  model  study  of 
Atehafalaya  Ray,  La.,  to  create  a  mesh  with  1  9 1>  7  bad  elevations 
I  r  o  m  a  mesh  with  1  9  7  7  bathymetry.  In  t  h  a  t  casi1  ,  1  9  h  7  depth  data 
were  processed  by  I.I.KVCRh,  then  that  output  tile  and  the  1977 
C.  K  0  K  N  input  file  w  e  r  e  used  hy  P  K  T  P  N  T  to  create  a  data  file  with 
new  elevations.  Recause  the  19r>7  data  did  not  cover  the  entiri 
Atehafalaya  grid,  the  interface  between  the  RE TP NT  output 
data  and  the  1977  mesh  had  to  he  smoothed  hy  hand. 

IP.  ha t a  other  than  bed  elevations  can  he  added  '  -  numeri¬ 
cal  meshes  in  the  same  manner  as  the  bed  elevation  additions. 

Po  step  n  strm'tion  Vo  r  i  I  i  c  a  t  i  o  n 

4d.  I'lie  WPS  Postronstrnct  inn  Verilication  (PCV)  research 
project  looked  at  how  suresshil ly  physical  models  have  predict'd 
changes  in  the  li  yi!  r.i  ii  1  i  e  and  sedimentary  regimes  within  a 
project  due  to  new  construction.  Information  Iron  the  PCV 
analysis  was  used  to  i  in  p  r  (  v  e  in  modeling  techniques. 

41.  The  1KIS-A  provides  a  good  means  ot  organizin'  results 
ol  PCV  sedimentation  studies,  w  h i c  h  analyze  large  volumes  <>  t 
spatially  distributed  bathymetric  d  a  t  a .  Since  comprehensive 

t i e 1 d  surveys  o l  postconstrurt ion  conditions  are  usually  not 
available,  Co  ■  n  s  o  t  engineers  condition  surveys  were  usually 
used  to  del  inn  project  depths.  liot.li  preconstruction  and  post¬ 
ed  n  s  t  r  n  c  L  i  o  n  surveys  were  digitized  and  read  through  i.I.KVGRh 
to  create  a  DMS-A  grid  ot  depths  for  each  map. 
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I  1  i 


4  > .  Sc;li  mi-lit  model  analyses  re  usually  pi-r  I  or  muil  on 
,i  sc  c  t  i  on  a  1  or  i-li-nontal  t»a  sis,  and  it  is  necessary  to  pe  r  f  o  r  m 
1‘CV  field  analyses  using  the  same  sections  that  were  used 
in  tiie  model  study.  4  IKIS-A  r  i  d  of  the  computational  sections 
..as  written  by  K ACC K 0  usin',  a  digitizer  1  i  1  e  defining  section 


4  1.  Two  depth  grids  and  the  section  g  r  i  <1  were  read 
through  HATHVOL  to  determine  the  shoaling  and  scouring  volumes 
for  time  periods  both  prior  to  project  construction  and  after 
const  reel  ion.  The  percentages  of  shoaling  change  for  each  section 
were  t  h  e  n  compared  with  the  model  shoal  in;;  predictions. 

4  4.  The  DMS-A  system  was  used  in  t  h  e  P  G  V  analysis  o  f 
t  h e  Tillamook  Hay,  Dreg,.,  physical  mod <*  1  . 


Sediment  Model  Verification 


4  1 .  rlie  initial  sedimentation  verification  analyses  of 

both  numerical  anti  physical  models  can  he  performed  using  DMS-A 
in  the  same  manner  as  the  P(JV  analysis.  The  prototype  condition 
survey  maps  showing  d a t a  tor  the  verification  period  are  used  to 
compute  the  shoaling,  rates  that  the  model  is  expected  to 
r  e  p  r  o  luce. 


Ate1 Vi  .i  f  a  1  aya  Hay  Deltaic  growth  Extrapolation 


4b.  The  study  of  deltaic  growth  in  Atchafalaya  Hay,  I, a., 
using,  extrapolation  techniques  is  an  example  of  a  specialized 
use  ol  the  DMS-A.  Bathymetric  data  from  various  sources  were 
converted  to  the  DMS-A  ridded  format  using,  1. 1,  K  VO  HD.  Then  an 
extrapnlati  analysis  using  regression  techniques  was 
pertorned  hy  computer  codes  written  to  read  the  DMS-A  gridded 
format . 
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program 

l)  M  S  I)  I  G 

•>G  P  LT 

F  K  I-  M  T 

TRANS  A 

F  f> 2  i;  N 

II  N  2  F  0 

M  r.  S  H  l 

•IKS  II  2 

MKSII  5 

'  :  KVGRI) 

R K  I  P  NT 

FACT.  R D 


NAME 


TAB1.K  1  l 

PROGRAMS  OF  THE  DM S 


K  U  N  C  T  I  0  X 


DIG  T  T  I  7.  INC  PROGRAMS 


R  e  add  i  g  i  t  i  zor  talileluut  put  an  d  converts 
it  to  input  format  for  EEI'.VGKD,  KKFMT, 

R  E  T  PM,  P  R  K  MESI1,  FACGRD,  (..UNPEG 

Quality  control  o  n  d  i  g  i  t  i  /.  e  '1  data, 
plots  digitized  data 


FORMATING  PROGRAMS 


Converts  special  digitizer  tiles  into 
Format  rvqui  roil  by  F  LEV  OR  It 

Transforms  ;>  ridded  data  from  one  grid 
system  to  a not  bur 

Converts  data  fi  le  coiled  by  Ff.21'0  but:  I 
to  standard  D’IS  gridded  binary  format 

Converts  DM  S  griddod  data  tiles  to  a 
form  that  can  be  transferred  between 
c  o  m  putors 


GRID  TRANSFORMATIONS 


to  r  go  s  L  a  I)  ii  1  a  r  tl  a  t  a 
d  a t  a  set 


into  an  x  -y  g  r  i  tl  d  e  d 


Merges  standard  hydrographic  survey  data 
into  x-v  griddod  data  set 

Merges  >;  ridded  digitized  data  trow 
several  naps 

Transforms  and  interpolates  randomly 
located  data  into  a  .ridded  data  set 

Extracts  data  values  at  randomly  spoci- 
1  i  e  d  locations  h  y  inter  no  1  a  t  i  n  g  f  ror 
a  g  r i d d e  d  d a t  a  set 


Sets  up  a  patch  or  I  act  or  tap 


■*.  - 


1  i 
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TAtU.K  I 

.  1  (contin  lie  d  ) 

I'K'ICRAM 

>;  a  m  !•; 

FUNCTION 

h  A  I  i  i  A  K  K  A 


I.  A'i'llVOt. 


I)  It  I’KK  1 


DATA  T  K  A  >.  S  r  t)  R  H  A  T  I  U  N  S 

Writes  a  set  of  g  ridded  d  i  l  forences  between 
two  data  sets  with  a  common  grid 

Calculates  areas  between  contours  iron 
a  grid  <1  e  d  data  set 

Computes  volumes  between  two  sets  ol 
g  ridded  data 

DATA  RKV1KW 

Prints  swaths  of  g ridded  data 
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Digitizer 

Ta  l>  1  e  L  2 

Data  File  Format 

for  Card 

Types 

1-10 

* 

Card 

Nu  mb  or 

Kiel  d 
Number 

Descript 

ion 

1 

1 

2 

Map  miBiier 

Co  d  e  specifying  d  a 
For  depths  =  3 
For  elevations  = 
F  or  AUTOMS  II  l  i  n  e 

t  a  type 

4 

s  =  1  0 

3 

] 

I'i  :;i  t  i  zcr  x-eoordi 

natc  o  t 

upper  1 

c  r  t 

ma  p  cor  n  c  r 

2 

Digitizer  y -c oo r  d  i  n a  t  e  o  t 

upper  l 

L*  1  t 

;ia  \>  corntr 

4 

1 

D  i  g  i  t  i  z  e  r  x  -  c  o  o  r  d  i 
corner  . 

n  a  t  e  o  ! 

upper  r 

i  /;  b  t 

n  a  p 

2 

Digitizer  y-coorili 
corner. 

natc  o  t 

upper  r 

i  h  L 

map 

5 

1 

Digitizer  x-eoordi 

n  a  t  e  o  i 

lower  1 

\  t 

m  a  p  c  o  rni-r 

2 

Digitizer  y-cuu r d i 

n a  tr  o l 

lower  1 

v  t  t 

nap  corner 

6 

1 

Di  g  i  t  i  ze  r  y  -  coo  r  d  i 
corner  . 

n  a  t  e  o  t 

1  o  w  e  r  1 

<•  1  L 

r  i  b  t  m  a  p 

2 

Digitizer  y-coonli 

co r  ne  r  . 

n  a  t  e  o  i 

1  owe  r  r 

i  i;  h  t 

d  a  p 

7 

1 

Cr id  x-coord  i  na  t e 
l.iioii  units. 

of  upper 

1  e  1  t  i 

•M>  «* 

o  r  no  r  in 

2 

Cr i d  y- e  oo  r  d  i  n  a  t  e 
1,000  units. 

of  upper 

1  e  1  t  I 

ii  p  c 

orm-r  in 

H 

1 

Cr i d  x  —  c oo  r  d  i  n a  t  e 
i  ,  ii  ■  1 1 1  units. 

o f  lower 

t'  1  g  b  t 

\n  a  p 

c  o  r  w  t»  r  \  n 

7 

Cr  i  d  y- e oo  r  <!  i  n  a  t  e 
l,0o(i  units. 

o  1  u  n  pe  r 

l"lt  n. 

a  p  corner  in 

y 

1 

S  pi-  rial  code  =  -  5  3 
interest  data. 

3  5  to  si 

g  n  a  1  s  t 

a  r  t 

ol  ;:nnt  <>T 

l  n  + 

1 

Pi  ;  i  t  i  z  e  r  x  -  e  oo  r  d  i 
o 1  interest. 

n a  t  e  of 

po  i  nt  d 

»*  t  in 

i  n  }*,  area 

o 

Digit  i  z e r  y -ooor d  i 
o 1  interest. 

note  ot 

p.O  i  lit  d 

c  :  i  ti 

in.;  f  rtM 

*  Card 
d  i i  t 

Ty  pc*  s  11  n 
i  x(»S  •  Sec 

d  b  i  g  l.e  r  vary  d  e  pe 
the  Addenda  tel  e  •. 

u d  i  ii"  on 

am.pl  •  '  • 

the  IV 

,!«'  < : 

:  I'lit.i 
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1  1  ; 


KI.KVORI)  Output  Da  t  .1  Kilt-  K  o  r  in  a  t 


l<i*  <  <>  !  t';  Wo  r  >\ 

i'i  11  r  lu*  r  u  11  pi  ht»  r 

S  t  .1  ml  n  r  il 

1 orunt 

ilo  uk'  y  wo  l  l 
Format 

Description 

I  l 

Hi  n.iry 

1 1 0 

l.K  H  DAT 

=  data  type  (3  lor  depths 
4  for  el  0  vat  ions) 

2 

i1.  i  n  a  r  y 

1  1  u 

■\X1  h 

=  U  T  M  x-roonlinnte  0  i 
the  up  per  left  corner 
of  t  h e  m  a p 

ll  i  11  a  r  y 

1  1  0 

NY  III. 

=  I' i'll  y-coordi  natii  of 
t  h  e  11  p  per  left  cor  n  e  r 

0  f  t  h  e  m  a  |i 

<♦ 

Il  i  11  n  r  y 

I  10 

•MX  1.  K 

-  U  T M  x-ooor  ;l  i  n a  t  e  0  1 
the  lower  right  corner 

0  f  the  m  a p 

binary 

1  1  0 

NY  l.K 

=  U  T  M  y-coord  in a t e  0  t 
tin’  1  0  w  i’  r  right  cor  n  0  r 
of  t  h e  n a p 

2-7  1-22 * 

Hi  nary 

2  2  Ab 

N  A  M  K 

=  (1  lines  0  t  132 

characters  each  of 
identifying  information 

3  1 

li  i  nary 

K  3 . 3 

DATASC 

=  K  1  a  i'(  1  0  r  data  units 
(  1.01  0  r  li  n  s  1  i  s  h  , 

.303  tor  metric) 

2 

Hi  nary 

1  b 

N  X  R  K 

=  Number  ot  grid  points 
i  11  the  x-d  i  red  ion 

1 

H  i  n  a  r  y 

1  n 

N  Y  K  K 

=  Number  ot  grid  points 
in  the  y  -  cl  i  r  e  c  t  i  0 11 

4 

binary 

K  li .  1 

DX 

=  (.  rid  increment  in  the 
x-d  i  rin't  ion 

3 

11  i  n  a  r  y 

Kb.  1 

1)  Y 

=  (.rid  increment  in  the 
y-dirert inn 

3-  1  - 

.Vi’KK  +  f  ; .  X  K  K 

Hi  nary 

binary 

Pi 

=  Two  dimensional  array 
containin';  data  values 
a  t  e  11  c  11  r  i  d  cell 

>l<  T  hi’  nu  n  b  i’  r 

the  iileptifie.il 

s  i  /.  e  11  11  <1  <•  h  n  r 

"  CHAR  ACT  V  K'  N  A '  1 1 . 

0  1  w  0  r  il  s 

inn  line 

a  r  t  e  r  s 

-112"  1  3 

that  a 

s  varies 

el.  !•  (i  1 

l!S  K  0  . 

re  r  <  •  q  u  i 

ili'l'i’iid  i  n  q 
t  it  «•  s  t  .1  n  1! 

red  lor  s  l  0  1  a  j>  e  0  1 

on  tlie  computer  word 

1  .1  r  d  version  of  l!HS  -  A 

I.  I  3 


DATA  MAN  A  (IKK  '  XT 


Ali|>r:.;iM"l  l  -  1  : 


i’SKK  I  ;-;sT«rc  i  \  o\s  for  i’kockam  i/isnio 


l . 

fro 

KI.K 


CYK 


S. 

tin; 


■>. 

S  ll  .1! 

p  r  o ! 
t  a  l. 

Ou_t  | 

h  . 


P ii  r  po s  e 


ill'-  purpose  iii  !).'l  SI)  I O  is  to  rr.i  d  digitized  data  from  .i  Tek- 
ii  i  x  * ')  ri  4  l  i  h  I  o  t  an.l  c  o  n  v  o  r  L  it  to  t  Ii  <■  proper  input  format  tor 
Y'CRP,  RKI'MT,  KKTPNT,  FACORTP,  PKEMKSII,  and  COKKKC. 


I :  s  e 


L'  ■<  e  c  n  t  i  o  n  is  startcil  with  the  followin';  control  cards  on 
PVI-.T  : 


C  FT  ,  ON  SI)  I  <•/  II  N=CK  l< ( l  H  *»  <  C  K > 
h-iSDir,  <CH> 

Follow  the  instructions  ;.;ivon  by  the  program.  Alter  execu- 
i  terminates,  t  y  pe : 

If  K  l’  I .  A  i ;  K  ,  T  A  i’  Ii  5  =  d  ip,  i  t  i  zerf  i  I  e  n  a  me  <  C  K> 


Subroutine  T  K  K  4 ')  U  may  only  he  used  under  CMC  NOS  time- 
rim;.  Other  non-ANSI  statements  are  noted  in  the  code.  The 
;  r  a  m  may  be  easily  modified  to  read  data  from  Tektronix  4  9  S  i 
lets. 

’  'll 

Output,  consists  of  flic  d  i  •;  i  t  i  /.  e  <1  data  on  1  o;,;  i  <•  a  1  unit  i . 


I.-  I  -  i 


DA  ,A  MAh  AOf.MKD  I  /  d"M'  1  0 


AD-A162  39*  USER'S  MANUAL  FOR  THE  GENERALIZED  COMPUTER  PROGRAM  ?/« 

SVSTEM  OPEN-CHANNEL  FL  (U)  ARMV  ENGINEER  UATERUAVS 
EXPERIMENT  STATION  VICKSBURG  MS  HVDRA 
UNCLASSIFIED  U  A  THOMAS  ET  AL  AUG  85  UES/IR/HL-85-i  F/G  13/2  NL 
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.*  i>!>  K  N  I)  U '  1  ].-2:  OSKK  I  N  ST  K  U  C  1  1  ON  S  M)U  PROGRAM  DCHI.T 


Pn  r  po s  e 


1.  i  lie  purpose  of  IKHM.T  is  to  plot  t  lit-  location  of  each  digi- 
t  i  zeil  point,  tin-  map  overlay  corners,  anil  the  area  of  interest 
t  r  o  ni  a  I  i  v  i  t  i  z  e  r  tile. 


lie  s c  r  i  p  t  i  on 


’ .  I'Sin-  the  nap  corner  coordinates  on  the  input  file,  all  of 
the  input  data  are  translorncd  to  plot  inches  ami  sent  as  input 
to  tin.'  CALCuMF  ;>iot  tin;,  routines. 


Use 


3.  The  program  is  available  on  the  WHS  DPS-fi  and  CYBKRNKT.  The 
followup  is  the  deck  structure  for  execution  under  the  DPS-8 
G  0  \  V  K  •<  subsystem  (  J  KN  command): 


1  I  $  S  N 

1  5  $  :  I  I) K  N  T  :  u  s  c  r  n  um  he  r  ,  n  a  me 

2  0  $  :  D  i>  I1  1 1 '  N  :  KO I1T  8  A  N  ,  KOM  A P 

OS  :  KDKTY  :  \KURM  ,  Nl.NO  ,  NI  ST  I  N  ,  KI)S 
40S  :  I,  1  II  I  S  :  (I  I  ,  3HK  ,  1  001JO 
50SSSI-. I,;:CT(  uscrno/PCRM/  |)CP1,T  ,  R) 
hub  :  |1  i’UATr. 

/()$  :  A  I , T K  K  :  n  ,  n 

—  your  replacement  cards  for  line's  m  through  n  — 


4 ')<)!>$  :  USE  :  l)PH" 

5 on m s : km:  cri  k 

bo  I  0$  :  I,  I  M  I  IS  :  ?o  ,  |  » K  ,  l  'HHinO 

5  I  2 1 1  $  :  i*  l<  M  r  I.  :  o  2  ,  8  ,  I,  ,  y  o  ii  r  digitizer  input  file 
5U3U$  :TAPi;7  :  o  3  ,  X  I  n  ,  ,  ,  .•‘Cl’hh 
'jllA  .I;;  :  f-.MIJOB 

A.  To  execute  the  program  on  CYBER NET,  use  1’KOOI.V  (Appendix  0). 


5.  The  spatial  digitizer  data  tile  is  in  standard 
!  o  ■;  i  c  .1  1  unit  02,  with  five  digit  line  numbers  added 
version.  The  input  to  EI.HVCKI)  consists  o  i  standard 
card  types  1-1')  (see  Table  1.2)  and  card  types  11-13 
below: 


f  o  r  in  a  t  o  n 
for  the  1)  1’  S  — 
d  i i  t  i  z  e  r 
a s  shown 


L-2-1  data  MANAGEMENT /DGPhT 


04/85 


Card  Field 

Num  he  r  Number  _ Description 


1  1  + 
1  2  + 


1  Special  code  =  -7777 

2  Data  point  value. 

1  Digitizer  x  -  c  o  o  r  d  i  n  a  t  e  o  i 

2  Digitizer  y-cu ordinate  ol 


*  *  Alternate  card 


types  11  and 


12  lor  each  d  a  t a 


1  3 


1  Special  ond-of-data  code 

2  Special  end-of-data  code 


Output 

6.  Output  consists  of'  a  plot  on  logical  unit  O'i 


data  point 
data  point 

value  1  oca 

-  P  9  9  V 

-  <1 S  <)  P 


data  management/dgplt 


L-2-2 


0  4  /  8  5 


A !)  1)  K  ’<  l>  IJM  1,-3:  USER  INSTRUCTIONS  FOR  PROGRAM  KKFMT 


Purpose 

I.  Tlie  purpose  of  pro  s' ran  RKMT  is  to  convert  a  digitizer  file 
from  a  format  that  is  easily  used  by  the  person  doing  the  digi¬ 
tizing  t  o  a  t  o  rra  a  t  used  by  the  K  L  E  V  C  K 1)  program.  It  will  also 
check  for  bad  data. 


J)osc  r  i  pt  i  on 

2.  Fach  coordinate  and  data  point  are  matched  in  a  one-to-one 
correspondence.  Digitizer  coordinates  are  checked  for  being  in 
the  range  between  09999  and  —99999.  Data  points  are  checked  tor 
being  in  the  range  between  1000  and  -1000.  The  program  stops 
when  it  finds  an  error.  It  will  not  catch  all  errors.  A  look  at 
the  entire  file  is  suggested.  Also,  UCPl.T  is  a  good  diagnostic 
program. 

1!  s  e 


Input 

1.  Input  digitizer  data  are  read  on  logical  unit  01.  After  the 
normal  digitizer  header  cards,  the  data  are  grouped  into  sets, 
starting  with  a  record  which  looks  like:  "  J(S  —  7  7  7  7  NNNNNN"  where 
XNNNNN  is  the  data  set  number,  followed  by  the  digitizer  coordi¬ 
nates  for  each  data  point  in  the  sot  in  21b  format,  followed  by  a 
record  which  looks  liKo: 

"fl-44 4 4^-4444" 

followed  by  the  data  values  for  each  point  in  the  set,  in  6X,  lb 
format.  The  symbol  ”  "  indicates  a  blank  character. 

Out p ut 

4.  The  output  tile  (logical  unit  02)  is  in  standard  I) MS  gri  dried 
format  as  described  in  Appendix  N.  In  this  format,  the  data  can 
he  read  by  KI.KVGRI). 


L-3-1 


DATA  MANAGEMENT/  RF.  FMT 


ADDENDUM  L-4:  USER  INSTRUCT  I  U  a  S  r'OK  PROCRAM  TRANSA 


Purpose 


1.  The  purpose  nt  TRANSA  is  lo  convert  regularly  gridded  data  to 
the  Ot-IS- A  g  ridded  format. 


Description 


2 .  The  code  reads  in  the  user's  grid  and  finds  the  minimum  and 
maximum  o  t  t  h  e  coordinates.  A  truncated  form  of  the  c  o o  r  d  i  n a  t  e  s 
and  the  data  are  written  to  t  lie  random  scratch  file.  The  output 
array  is  tilled  with  the  area  of  noninterest  code  -9  99.  The 
coordinates  are  reread  from  the  scratch  file  and  converted  to  the 
grid  index  using  a  transformation  based  on  the  hard- wired  grid 
spacing.  Grid  cells  not  having  data  remain  set  to  -999.  Output 
is  placed  on  f i L  e  code  02. 

3.  The  grid  spacing  (DX  for  x-direction,  DY  for  y-d i r e c t i on ) , 

units  flag  (I)ATASC  =  1.0  for  English,  .305  for  metric),  and  the 

data  type  flag  (NX  =  3  for  depths,  4  for  elevation)  are  all 
hardwired  into  the  code. 


Use 


4.  The  program  is  available  on  the  WES  DPS-8  and  CYBERNET.  The 
following  is  the  deck  structure  for  execution  under  the  DPS- 8 
CONVERT  subsystem  (JRN  command): 


10$$  N 

1 5  $ :  I  DENT : u  s  e  r  nun  he  r  ,  n  a me 

20$ : 0  P  T 1 0  N : PORT  RAN , N0MAP 

30$  :  FORTY  :  NFORM  :  Nl.NO  ,  N  LSTT  N  ,  EDS 

40$ : El M ITS : 1 O , 26K  ,  ,  5000 

—  canl  images  ol  the  TRANSA  prog, ram  — 


5oii(i$  :  I-. x  ecu  rr 

5l>  1  0$  :  l.  I'll  TS  :  1  00 , 6  8  K  ,  ,.5000 
50  1  5$  :  FI  l,E  :  20  ,  X  3R  ,  20K 

50  20 $  :  p  r ;i  K i, :  0  1  ,  K  ,  1, ,  y on r  input  gridded  data  file 
5  o  3 1 1  $  :  T  A  P  E  9  :  0  2  ,  X  2  D  ,  ,  ,  ,  y  o  u  r  n  a  ,n  <  ■ 

31)40$  :  DATA  :  1 


—  your  run  control  input  — 

h  000  $ : END JOB 


1,-4- 1  DATA  MANACEMF.NT/TRANSA 


5.  The  program  is  executed  on  CYHERNET  through  PiiOCLV  (see 
Appendix  0). 

6.  Regularly  gridded  data  are  read  in  on  logical  unit  01.  The 
output  file  on  logical  unit  02  is  in  DMS-A  standard  gridded  form. 

7.  The  TRANSA  run  control  input  is  as  follows : 

Card 

Number  Format  _ Description _ 

1-12  2  2A6  12  lines  of  identification  information 

for  DMS  formatted  output. 

The  gridded  input  format  is  as  follows: 

Card  Field 

N  umber  Number  Format  _ Description _ 

1+  1  3X.F10.2  x-co ordinate  of  grid  point. 

2  3 X, FI  0.2  y-coordinate  of  grid  point. 

3  3X.F10.2  Data  value  at  grid  point. 

**  Input  a  card  type  1  for  each  /.rid  cell  ** 


DATA  MANAGEMENT/TRANSA 


L-d-2 


ADDON  OUM  I.- 5:  USKK  INSTRUCTIONS  FOR  PROGRAM  K021M 


Pn rpose 


1.  The  purpose  of  program  F02UN  is  to  convert  a  g  ridded  data 
file  that  has  been  coded  by  II  M  2  F  0  back  to  the  s  t  a  n  d  a  r  d  0  M  S  -  A 
binary  ^ridded  format. 


Description 


2.  The  80-c o l urn n - w  i  d e  coded  data  tiles  are  converted  to  the 
binary  CMS -A  g ridded  format. 

3.  r’OXIJN  is  executed  on  CYBKRNKT  by  use  of  PROCLV.  Inpul 
consists  of  an  U.N2KI)  (Addendum  L-b)  output  file  on  Logical  unit 
01.  output  is  a  DilS-A  binary  data  file  on  logical  unit  02. 


L-5  - 1 


DATA  MA.N'AGKMKNT/  K02U 


adijkkdum  i.-h:  us  hr  instkuc  rio;.s  for  program  un2Fo 


Purpose 


1.  Thu  purpose  ot  program  UN2F0  is  to  convert  DMS-A  gridded  dot 
files  to  a  lorn  that  can  he  transferred  between  computers. 


Description 

2.  The  binary  P’lS-A  gridded  data  files  are  converted  to  an  80- 
col  timn— wide  coded  lormal  (card  image). 


I  tor 

; 


i 


i 


Use 

3.  UN2K0  is  executed  through  PROCl.V  (see  Appendix  0).  The 
binary  input  file  is  read  on  logical  unit  11  and  the  formatted 
output  file  is  written  to  logical  unit  01. 

A.  The  deck  setup  for  execution  under  the  Honeywell  UPS-8 
convert  subsystem  (JRN  command)  is  as  follows: 

1  0  $  $  ii 

2  0  $  :  1 1)  F.  M  T  :  u  s  e  r  i  d  ,  n  a  m  e 
30  3 : OPT  1  OX ; FOR  TAX , NOMAP 

40  S  :  FORTY  :  N  FORM  ,  NLNO  ,  M.ST  1  N  ,  PI)S 
30  C  PROGRAM  l'  .  2  K  U 
DO  DIM  FN  SION  N(1000) 

7  0  KkWlND  11 

75  R  K  A!)  (  I  1,5)  I.K  M)  AT  ,  MX  U  I,  ,  M  Yl!  1.  ,  MX1.  R  ,  M  Yl.  R 

8  0  II  5  F0KMAT(  5  U  0  ) 

H2  W  K  T  TK  (  1  ,6)I,KNDAT  ,  MX  H  I. ,  M  Y  II 1. ,  MXl.R  ,  MYLR 
b5?/a  F0RMAT(  5  110, 30X) 

90  PRINT,  "TDKNT  h  !•'.  A  D  ON  INPUT  TAPF." 

1 00  DO  21  1=1,6 

I  1  0  RF.  \l)  (  l  I  ,  3  )  (  N(  J  )  ,  J=  1  ,  22  ) 
l  20*' 3  FORMA  l’(  2  2A6  ) 

130  PRINT3,(N(J)  ,.1=1  ,22) 

13  5  W  K  rr  K  (  1  , 4  )  (  N  ( .1  )  ,  J  =  1  ,  2  2  ) 

140/14  FORMAT (  1  1  A6  ,  1  4X  ) 

I  50// 2  1  CONTTNUF 

160  R I-.  A !)  (  I  1  ,  7  )  DAT  AS  G  ,  NXKF  ,  N  YRF  ,  I)  X  ,  H  Y 
I  70117  K 0 K M  A T (  F  5 . 0 , 5 X  ,  2  l  6 , 2  F 6 . 0  ) 

ISO  WK  I  TT  (  1  ,8  )  DAT  A  SC  ,  NXKK  ,  NYKK  ,  l)X  ,  DY 

1  9D./K  m ) k M A T (  F 5  .  3 , 3 X  ,  2  1  6 , 2  F6  .1  ,  46X  ) 

200  no  64  T  =  1  ,  N Y  R K 

2  10  i<  h  A  D  (  1  1  )(  a  (  J  )  ,.J=1  ,  N  X  K  F.  ) 

220  W  K  I  T  K  (  I  ,  5  )  (  N  (  J  )  ,.1=1  ,  N  X  K  K  ) 

250#64  OONTINUK 

2  40  RKW  INI)  II 
2  50  KKw'IXD  1 


1.-6-  1 


DATA  MAMAOF.MF.NT/ UN2FO 


260  PRINT,  "RUN  COMPLETE" 

270  STOP 
280  END 
290$ : EXECUTE 

300$  :  TAPE9  :  1  1  ,  X  1 1' ,  ,  ,  ,  you  r  DMS-A 
3  1  0  $  :  FILE  :  0  1  ,  X  2S  ,  l  0 1, 

320$ : UTL2 
3  3  0  $  :  E  I  L  E  ,  I  N  ,  X  2  D 

340$ : TAPE 9 : 0  T  ,  1 T 1 D ,  ,  ,  .filename,  , 
350EDEE  IN.CFUC. 

36  OF  DEC:  OT  ,  NLAB  ,  l  BM  ,CI«0  ,  K80  . 

3  7  0  K OPT  IN  AND  OT.KECCT. 

380PKOC  REWIND  IN.  COPY  IN  TO  OT 
390$ : ENDJOB 

Tin*  ahove  jcl  will  write  a  tape. 


b> 


t  a  p  e  n  u  in  b  e  r 


DEN  8 


I  V  IDE. 


DATA  MANAGEMENT/UN2F0 
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AODKNDUM  L-7:  USSR  INSTRUCTIONS  FOR  PROGRAM  MKSHI 


Purpose 


1.  The  purpose  of  program  MKSIII  is  to  mesh  spatially  digitized 
data  from  a  sediment  characteristics  map  with  tabular  values  for 
depth,  mean  grain  size,  sorting  coefficient,  and  sand,  silt,  and 
clay  p  e  r  c  e  n  t  a g e s . 


Description 


2.  The  input  digitizer  coordinates  are  matched  with  the  selected 
tabular  data  to  lorn  an  KLKVGRD  digitizer  input  file.  The  trans- 
lormation  coordinates  and  the  area  of  interest  definition  are 
simply  copied  from  the  input  file  to  the  output  file. 


Use 


3.  MKSHI  runs  under  the  Honeywell  DPS-R  time-sharing  system.  The 
program  and  data  files  must  be  on  the  individual  user's  disk, 
file  space.  To  run  the  code,  log  in  to  the  Honeywell  and  type 
r  "KRN  MKSIII."  The  program  will  interactively  ask  the  user  input 

and  output  tile  names  and  what  kind  of  data  are  needed  to  be 
output.  MKSIII  will  write  depths,  mean  grain  sizes,  sorting 
coefficients,  sand  sample  percentages,  silt  sample  percentages, 
clay  sample  percentages,  and  silt  plus  clay  sample  percentages. 

Input 


4.  The  spatial  digitizer  data  file  is  in  standard  format  on 
logical  unit  01,  w i t h  live-digit  line  numbers  added  for  the 
DI’S-S  version.  The  input  card  image  records  1-10  are  in  standard 
format  (Table  1.2)  and  card  types  11-12  are  shown  below: 


On  r  <1  Kiel  <1 

Number  Number 


Description 


1  1  + 
1  2  + 


1  Special  code  =  -7777 

2  Data  point  number. 

1  Digitizer  x-coordinate  of  data  point. 

2  Digitizer  y-coordinate  of  data  point. 


**  Alternate  Card  Types  11  and  12  for  each  data  value 
1  o  c  a  t  i  o  n  *  * 


l  3 


Special  cml-ol -data  code  =  -9999 
Special  e  ml -o l -data  code  =  -9999 


I 


1.-7-  I 


DATA  MANAGKMKNT  /  MK.SH  I 


5.  Tlie  tabular  data  file  (logical  unit  02)  is  as  follows, 
with  a  five-digit  line  number  added  for  the  DPS-8  version 
only.  Input  a  data  record  for  each  digitized  point  location 

Field 


Number 

Fo  rmat 

Description 

1 

1  lx , F4  .  1 

Depth  value  at  this  point  It  will  be 

multiplied  hy  10  and  truncated  on  output. 

1 

F  5  .  3 

Moan  grain  size  at  this  point.  It  will  be 

multiplied  by  1000  and  truncated  on  output. 

2 

F  4 . 2 

Sorting  coefficient  at  this  point.  It  will 

he  multiplied  by  100  and  truncated  on  output 

3 

12 

Sand  sample  percentage  at  this  point  . 

4 

12 

Silt  sample  percentage  at  this  point. 

5 

12 

Clay  sample  percentage  at  this  point. 

6 

13 

Point  numbe  r 

Output 

6.  The  output  file  from  MF. SHI  is  suitable  for  input  directly  to 
KLEVGRD  for  conversion  to  the  standard  DMS-A  g ridded  format. 


DATA  MANAGEMENf/MESHl 


L-7-2 


■ )  4  /  R  s 


Alim- V)l!ll  1,-8:  USKK  I  N  ST  Hi)  C.  I  IONS  FOR  I’KOGRAU  MKSN2 


Purpose 

1.  I'iif  purpose  iif  program  MI1SH2  is  to  nosh  spatially  digitized 
data  from  a  bottom  elevation  nap  with  fathometer  values  along 
transects  or  ranges. 


Description 

2.  The  input  digitizer  coordinates  of  the  start  and  the  end  of 
the  r  a  n  g  e  s  o  f  depth  data  are  matched  with  the  d  e  p  t  h  data  to  for  in 
an  I-.  I.  K  V  G  R I)  digitizer  intuit  tile.  The  transformation  coordinates 
and  the  area  of  interest  del  in  it iuu  are  copied  from  the  intuit 
MU'  to  tile  output  tile.  Thu  starting  points  o  i  ranges,  ends  of 
tin'  range  s,  and  distances  along  ranges  are  used  to  compute 
discrete  x  and  y  digitizer  coordinates  tor  eacti  data  point. 

3.  The  nap  corner  coordinates  in  the  input  digitizer  file  must 
lie  perfectly  rectangular. 

Us  e 

4.  MI-.SII2  runs  under  tile  UI’S-H  t  i  m  e -s  li  a  r  i  n  g  system.  The  program 

and  -lata  tiles  must  he  on  t  h  e  individual  user's  disk  file  space. 

To  run  the  code,  log  in  to  the  Honeywell  and  type  "FUN  MKSH2." 

The  program  will  interactively  ask  the  user  input  and  output  tile 
names. 

3 .  The  spatial  digitizer  data  tile  on  logical  unit  01  is  in 

standard  format,  with  five-digit  line  numbers  added  tor  the  DPS-8 
version.  i'lir  input  card  types  1  -  I  0  are  standard  digitizer  format 
(Table  1,2)  and  card  types  11-14  are  shown  below. 


f  ard 

1  umbi'  r 

!•*  i  r  !  cf 
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DATA  VA\ ACF-’lu,  i/  MI.SM2 


h  .  X  hi1  <1 e  p  t  h  (i  a  t  .1  tile  on  logical  unit  (12  is  ns  toi  luus,  with  . 
sf  vi’n-d  i  s',  i  t  Lino  number  added  for  the  DPS  — K  version  only.  Then 
are  four  d  1  s  t :u  n  c  e  /  d  e  p  t  h  data  pairs  per  input  record.  A  value  i 
4  4  «  4  9  9  for  the  distance  signals  t  lie  end  of  data  lor  a  part  i  cul  a 


C a  r  d  Kiel  d 

hum  her  dumber  Format 


1  +  l  ,  i  ,  5  ,  7  Fin! 


2,4,h,K  1-7.2 


_ lie  script  ion _ 

File  descriptor  (skipped  over). 

File  descriptor  (skipped  over). 

Distance  of  data  point  from  start  of 
r;!ni;c  ,  in  FT"!  or  user's  coordinate! 
=  499 999  to  si  anal  the  end  of  data 

particular  ran  a  e  .  Start  the  next  r; 
on  a  new  card  imai;e. 

Depth  val  ii  o, mill  tipi  iod  by  |  nil  and 
truncated  on  output. 


Input  enough  card  type  1  '  s  as  needed  for  al  I  input 
d  a  t  <i  points  tor  all  ot  the  ran;,es  ** 

7.  The  output  file  (logical  unit  03)  from  MKSU2  is  suitable  for 
input  directly  to  KLKVGRD  for  conversion  to  the  standard  Il'-iS-A 
■;  r  i  !  d  e  d  tor  m  a  t  . 


DATA  MANAGEMENT/MESH2 


AOmir.'Jl-'i  L-9:  L'SKR  IrtSl  *LCi  IONS  FOR  PROGRAM  MKSH3 


Purpose 


1  .  The  ]ui  r  pose  o  l 
.1  .i  t  a  tiles  into  a 


program  HESU3  is  to  mesli  separate  digitizer 
single  digitizer  input  tile. 


Description 


2.  Tlie  program  expects  each  input  file  to  contain  an  arc- a  of 
interest  and  it  * i 1 1  handle  any  number  of  area  of  interest 
patches  per  tile.  A  total  of  tour  input  files  can  Se  used.  All 
ot  ttie  input  data  can  he  translated,  hut  not  rotated,  to  be 
matched  together.  Al  l  innut  is  assumed  to  have  come  from  the 
same  digitizer.  "laps  being  meshed  together  do  not  have  to  he 
adjacent  to  each  other  or  meshed  together  into  a  rectangle. 

3.  The  input  digitizer  coordinates  are  translated  to  match  the 
coordinates  on  the  input  file  that  was  chosen  as  the  base  file, 
usin,;  the  corner  UTM  or  user's  coordinates. 


P«c 


4.  'll.SII  3  runs  under  the  Honeywell  DPS-o  time-sharing  system  and 
CY  HIP.  NET  PROCI.V.  The  program  and  data  files  must  be  on  the 
individual  user's  disk  file  space.  The  program  will  interac¬ 
tively  ask  the  user  input  and  output  files  names  and  which  input 
tile  should  be  used  to  compute  the  output  file's  scale. 


5.  Tli  e  spatial  digitizer  data  files  (logical  units  I  -  4 )  are  in 
standard  formal,  with  live-digit  line  numbers  added  for  the 
Honeywell  version.  The  input  card  types  110  are  shown  in  Table 
1,2  and  card  types  11-13  are  in  the  format  shown  below: 


(,'a  rd  riel  1 

Number  Number 


Do  script  it>  n 


1  Sptcial  code  «  -7777 

2  Data  value  at  a  point. 

1  Digitizer  x -coordinate  of  data  point. 

2  Digitizer  y-coo  r d i na  t  e  o 1  data  point. 

Alternate  Card  Types  II  and  12  for  each  data  valui 
location  -  * 

1  Special  e  n  d  —  o  f  —  d  a  t  a  code  =  - l 2)  h  9  ■) 

2  Special  end -of -data  code  =  -9  9  9'1 


l. 


-9-1 


DATA  II  AN  AC  KM  I.  NT  /  .M  f.  S II 3 


apim-mu  i  L-l'U  usi.r.  inst.-.i  (.Tti)::s  fou  program  ki.kvgkd 


Purpose 


t.  The  purpose  ot  program  KI.KVGKD  is  to  create  a  I)  MS- formatted 
grid  trom  a  file  of  randomly  scattered  X,  Y,  and  7.  data. 


Description 


l.  [ n pu t  digitizer  coordinates  are  converted  to  the  user's  grid 
coordinates.  Dept  ns  are  assigned  to  each  regular  grid  cell  based 
on  a  linear  nearest  neighbors  averaging  scheme.  (see  paragraph 
2  4  of  Appendix  I, . ) 


Use 


3.  The  program  is  available  on  the  WKS  DPS-b  anil  CYBKKNKT. 

4.  Deck  structure  for  execution  under  the  DPS-b  CONVKKT 
subsystem: 

$$N 

$ : OPT  I ON : FORTRAN . NOMAP 
Stl'SK:  .  G  T  L,  l  T 

S  :  FORTY  :  NFORM  ,  NM.NO  ,NI.STI  N  ,  FDS 
$  :  1. 1  I  IT S  :  ,  2HK 

—  card  images  ol  the  KI.KVGKD  prog, ram 
$  :  K XI. CUT K 

S  :  l.l  Ml  TS  :  I  ,  7  OK  ,  ,  20000 
S  :  r  1  LK : 2 0 , X  3 K , 2  5  K 
$  :  F 1 1.  F. :  2  1  ,  X  4  K  ,  2  5  K 

5  :  PKMF I. :  1  0  ,  P.  ,  h  ,  your  userld/your  scattered  data  input  file 
$  :  PKM  K  I. :  1  I  ,  W  ,  1. ,  yo  ur  userid/yuur  DM  S  grid  file 
$ : DATA :  I* 

your  run  control  input 
$  :  Ui.UJOK 

3.  The  CYBKKNKT  version  of  KI.KVGKD  is  available  through  PROCl.V 
(see  Appendix  0 )  . 

Input 


6.  Kun  control  input  (CYHKKKI'T  only)  is  shown  below.  Kach 
keyword  is  in  columns  I  -  3 .  The  !  o  I  1  o  w  i  u  g  I  i  e  1  d  s  are  on  the  same 
card,  separated  by  spaces  (free  I  or  mat).  It  is  read  on  logical 
unit  0  3. 


1  o-  | 


DATA  MAN  AC!-'  >•  K  NT 


C.RS 

MKT 

SC  A 


KCU 


D  i  IP 


T 


real 

u  mi  e 


r  e  .i  1 


n  u  a  e 


character 


c  ha ractcr 


Grid  spacing  in  user's  units. 

Supply  keyword  only  if  using  metric 
units.  Default  is  English  units. 

Number  by  which  to  multiply  the  input 


data.  This  value 

is  list'd  to 

control 

p  r  e  c i s i on  o 1  i  n  t e 

;; i*  r  oprmt  i 

mis  • 

Supply  keyword  if  a 

n  echo  of  the  i 

n  jhi  t 

data  are  desired. 

Default  is 

11  o 

(» c  ho 

Grid  swath  dump  con 

trol  option 

# 

=  KU  1,1,  for  a  dump 

ill  the  o  n  t 

i  ri- 

n ;  •  s  - 

t  orimitt  e  d  g  rid. 

=  PART  I  A!  for  a  dump  of  the 

DMS- 

formatted  grid  w  i 

t  h  o  u  t  g  r  i  d 

lini1 

s 

t  h  a  t  are  totally 
interest . 

out  of  the 

are  a 

o  t 

=  MONK  tor  no  grid  swath  dump  (default) 

Title  to  add  to  top  of  HHS-forinat  ted 
grid.  Dp  to  12  lines  of  titles  may  be 
supplied  , 


7  .  T  h  e  input 

t  i 

1  e  of  d a  t  a 

(logical 

unit  1 d )  at  sea  1 1 

•  re  d  X  a  n  d  3' 

locations  m a  y 

be 

e  ne  rate  d 

using  the 

digitizer  at  Ins 

trimentat  ion 

Services  0 i v  i  s 

ion,  usin<’,  the  Tektron 

i x  digitizer  unde 

r  tlie  con¬ 

trol  ot  a  program  called  11 

MS  IHG,  or 

hv  hand •  The  f i l e 

i'  o  r  m  a  t  >  s 

standard  digit 

i7,  er  file  format  as  shown  in  Table  1,2. 

Card  types 

11-13  are  as  shown  below. 

Card  T  y  p  e 

F  i  t*  1  d 

Do  s  c  r  i  p  t 

ion 

1  1  + 

1 

Special 

code  =  -7777 

2 

Depth  or 

e lovation  value. 

12  + 

1 

Digitize 

r  x-co ordinate  of 

1  o  c  a  t i on  o  t 

d  e  p  t  h 

v  a  L  u  e  . 

■> 

Digitize 

r  y-c o o  r d i n a  1 1  of 

location  o 1 

depth 

v  a  1  ue. 

*  * 

Al ter nate 

Card  Type 

s  II  and  12  for  e 

a  o  h  v  ,  y  ,  7. 

trio.  Also,  mu l t i p 1 

i*  cards  of  Type  12  can  to  1  low 

a  single 

Type  II  c  a 

r  d  for  areas  wit h 

a  co n  s  t  a  n  t 

deptti  or 

e 1 e  v  a  t ion . 

i'{  li 

1  3 

1 

S  p  e  c  i  a  1 

e  n  d -o  f -d  a  t  a  c o  d  o 

=  -nnno. 

’) 

4. 

S  p  e  c  i  a  1 

on d -o f -d a t a  code 

lint  put 

w  .  I S  r  i  d  d  e  d  data  are  written  as  output  to  1  n  ■;  i  e  a  !  u  n  >  l  11. 


DATA  MANAGEMENT 


L-  1  0  - > 


AUDKNDUM  T.-ll: 


USSR  INSTRUCTIONS  FOR  PROCRAM  KKTPN  T 


Purpose 


I.  The  purpose  ol  program  KtTPNT  is  to  retrieve  data  at  speci¬ 
fied  random  locations  from  a  .nMS-formafted  regular  grid. 


Oesc r i p t i on 

2,  The  program  computes  a  weighted  average  data  value  lor  each 
requested  point  based  on  the  values  at  the  lour  corners  of  the 
grid  coll  within  which  the  point  is  located. 

Use 


j.  RKTPNT  is  available  on  the  WKS  UPS-K  and  on  CYBKRNtT.  Deck 
structure  lor  execution  under  the  DPS-S  COKVKRT  subsystem: 

$ : OPT  I  ON : FORTRAN,  IOMAP 
s  :l!SK:  .0TL1T 

$  :  FORTY  :  NFORM  ,  NI.N'O  ,  dl.ST  T  N  ,  FDS 
?  :  I.I  I  I  TS  :  ,  2d' 

—  card  images  of  the  RT.  TP  NT  program  -- 
$ : KXKCUTI 

$  :  PR  ••!  FI. :  I  0  ,  R  ,  I. ,  use  r  i  d  /  you  r  grid  tile 
$  :  P K M F I. :  I  I  ,  W  ,  L  ,  use  r  i  d  /  y ou r  output  tile 
S  :  I’RMFI.:  ?0  ,  R  ,L  ,  user  i  d/your  specified  point  tile 
S  :  K  Nil  Jo’,; 

A.  The  CYKFRVKT  version  of  KCTPAT  is  available  through  PROCI.V 
and  it  will  work  directly  on  G  F  C  t  N  input  files  to  add  bed  eleva¬ 
tions  alter  nodal  x  and  y  coordinates  have  been  set. 

Input 

j.  Run  control  input  expected  on  logical  unit  20  (used  only  when 
working  with  OFGC N  input  files,  free  field  TABS  format)  is  shown 
below.  i‘ich  keyword  is  in  Column  l-T.  Data  values  are  ’  n 
succ  e  e  d  i  n  i*  columns  in  free  format: 


L- II  -  1 


n  AT  A  MAN  AG  F.  M  K  N  1'  /  K T  P  ft  T 


04/85 


Card 

Ke  y wo  r d 

Da  t  a 

Value 

Description 

DAT 

re  a  1 

Datum  of  TABS  grid,  elevation  of  zero 
depth  (Default  =  1OO.0) 

0  U  L 

r»*al 

x  -coo  r  d  i  n  a  t  e  <>  t  TABS  coordinate  system 
offset  relative  to  I1MS  grid  file 
(Default  =  0.0) 

r  o  1 1 

y-coordinate  of  TABS  coordinate  offset 
relative  to  DM  S  grid  (In' fault  =  0.0) 

SCA 

r  a  l 

The  depth  J  a  t  a  on  the  PMS  g  ridded  til.' 
is  divided  by  this  value?.  (Default  = 

1.0) 

SOB 

rea  L 

The  coordinate's  on  the  CFGKN  input  lile 
are  divided  by  this  value  so  that  they 
can  fit  2  lb  format.  (Default  =  10.0) 

RMA 

none 

Special  keyword  to  tel  1  RETI’NT  to  process 
an  GFGF.  N  input  file.  This  keyword  is 

optional  if  other  rim  control  cards  are' 
supplied  . 

6.  A  digitizer  fiLe 

10),  is  supplied  if 
The  format  is  shown 

of  specified  point  locations  (logical  unit 
the  program  is  not  working  with  GFCEN  files 
he l ow : 

Card  Type 

Fie  l  a 

Descript  ion 

1 

1 

Special 

code,  set 

=  -  i 

2 

S  a  n  e  a  s 

data  type 

code  011  0: !  s  g  r  i  1  el  e  • 

file. 

Depths  = 

3  ,  e  1  e v a t  inns  =  4 . 

2 

1 

Special 

flag, 

set 

=  -<) 

2 

Special 

f  1  a  y  , 

SOL 

=  -') 

3  1  x-coordinate  of  upper  lett  map  corner  in 

1  0  0  0  '  s  of  state  t;  r  i  (I  fret 


2 

y-coordinate  o{  upper 

l 

e  1  t  ni  a  p 

corn  e  r 

i  n 

1  ODD  ’  s 

of  state  r  i  d 

f  ( 

(  t 

4 

1 

x  -  c  o  o  r  d  i  n 

ate  of  lower 

r 

i 

ht  'Map 

c  o  r  no 

r 

in  1000 

1 s  of  state  g 

r 

i  (1 

i  t 

2 

y-coordinate  o  t  lower 

r 

i 

lit  'Ml  p 

c  o  r  1 1  e 

r 

in  1000 

' s  of  st  a t  e  g 

r 

i  (1 

1  ret 

5 

1 

Digitizer 

x-coord  i  n  a  t  e 

o  t 

u  p  per 

left 

nil  p 

corner 

2 

Digit  i  ze  r 

y-cnord i n a t  e 

o  t 

u  p  pc  r 

lett 

m.l  P 

ceirni'  r 

6 

1 

Digit  i  z  e  r 

x-coord i n  a  t  e 

u  (' 

u  p  ;u»  r 

r  i  g  h  t 

nap  corner 

2 

Di  g  i  t i ze  r 

y-coordinate 

o  f 

upper 

r  i  gh  t 

ma  p  corner 


| 


DATA  MANAGEMENT /RETPNT  L-ll-2 


I 


Card  Type 


Field 


Description 


7 

i 

Digitizer  x-coordinate  of  lower 

1 1?  f  l  pi  a  p 

corner 

2 

Digitizer  y-coordinate  of  lower 

J  e  f  t  m/i  p 

corner 

■  i 

1 

Digitizer  x-coordinatc  of  lower 

right 

map  corner 

2 

Digitizer  y-coordinate  of  lower 

right 

map  corner 

u 

1 

Spec i a  1  code  =  -  2 

7 

Special  code  =  -2 

Ida* 

1 

Special  code  =  -7777 

2 

Point  number  to  be  retrieved. 

Kibe 

1 

Digitizer  x-coordinate  of  point 

t  o  be 

retrieved 

2 

Digitizer  y-coordinate  o i  point 

to  be 

retrieved 

i  *  * 

Alternate  Card 

Types  10a  and  10b  for  each  data 

point 

value  to  be  retrieved  *** 

1  1 

1 

Special  end-of-data  code  =  -9999 

2 

Special  end-of-data  code  =  -9999 

On  t  pu  t 

7.  Kaw 

KK.TPST  output 

is  written  on  logical  unit  11  in 

t  he 

t  o 1  lowin 

■;  1  urmat  : 

Field 

Format 

Description 

1 

l  10 

Point  number 

2 

l  l  0 

x-coordinate  of  point 

J 

l  1  o 

y-coordinale  ot  point 

4 

V  1  n .  2 

Data  value  at  point  location 

=  0.00  if  point  lies  within 

grid. 

but  out  si  In  of  the  area-of- 

interest  . 

Points  that  are  off  ot  the 

grid  a r e 

set  to  1.00  on  the  DPS-.S  and  are  not 

written  to  t  li  i  s  file  on  the 

C  Y  li  1.  It K  T 

version. 


L-  ll-'J 


DAT  A  M  A  N  A  C I :  M  C T  /  P  i-  T  P  N  T 


All!)!'. M)U  I  l„- 12:  USER  1  NST.iLC  f  IONS  FOR  PROGRAM  FACGRl) 


Purpose 


1.  Tiie  purpose  ol  FACGKD  is  to  transform  a  digitized  boundary 
region  into  a  DtlS-A  formatted  grid  for  use  as  an  overlay  to  an 
KLEVGRi)  or  TRANSA  output  file.  It  can  be  used  to  define  patches 
of  constant  factors  within  which  the  EI.F.VCRD  or  TRAKSA  data  can 
he  anal  y zed . 


Description 


I  ytir 


2.  The  p  r  o<;  r  a  in  roads  t'ne  input  digitizer  file  and  the  data 
cards.  The  entire  array  is  filled  with  -999.  The  program  then 
assigns  to  cacti  grid  cell  the  appropriate  patch  number  within 
which  it  is  located.  Cells  outside  the  area  of  interest  retain 
value  o 1  -999. 


Tse 


3.  The  program  is  available  on  the  WES  DPS-8  and  CYBF.RNET.  The 
following  is  the  deck  structure  for  execution  under  the  DPS-8 
CONVERT  subsystem  (JU.\  command): 

2  0$ : OPT  I  ON : FORTRAN : NOMA P 

30$  :  FORTY  :  N  FOR  M  ,  XL  NO  ,  NLST 1  N  ,  FI)  S 

40$:1,  IMITS:0  5,32K,  ,10000 

—  card  images  of  the  FACCRD  program  — 

5000$ : EXECUTE 

5010$:!.  I'll  TS:  20.4  5K,  ,20000 

5020$  :  PRMFI. :  0  1  ,  K  ,  L  ,d  i i  t  i  zer  input  file 

50  30$  :T\PK9  :  1  I  ,  X  2 1) ,  ,,,your  name 

5040$ : DATA :  I* 

—  your  run  control  input  — 

6000 S : K.XDJUB 


4.  FACGRl)  is  executed  on  CYBERNET  through  PK0CI.V  (Appendix  0). 

5.  The  FACGRl)  run  control  input  (logical  unit  01)  is  as  follows 


I. -12-1  DATA  MAN  AG  KM  K  NT  /  F  ACC  R  I) 


Number  Number 


Format 


Description 


1 

2 

3-  1  5 


1 

2 

1-22 


free 

free 

2  2  Ao 


Grid  spacing  in  IIT’i  nr  user's  units. 
I '  n  i  t  type  f  1  a  i\ 

=  1.0  for  K  n  1  i  s  h  units. 

=  .305  for  metric  units. 

12  lines  of  identification 

information  tor  D  M  S  formatted 
output  . 


6.  The  spatial  digitizer  ci.it  a  file  is  in  standard  format  lor 
card  types  1-1!)  (see  Table  1,2),  with  live-digit  line  numbers 
added  for  the  Honeywell  version.  Card  types  11-13  are  in  the 
format  shown  below: 


Record 

Word 

Number 

,N  umber 

De  s c  r i p  t i on 

1  1  + 
1  2  + 


1  Special  code  =  - 6  6 b  6 

2  I’a  t  c  h  numhe  r  . 

1  Digitizer  x-coordinate  of  point  defining  pate 

2  Digitizer  y-courd  in.itu  of  point  dotinjn;,  pate 


1  3 


*  * 


Input  a  Card  Type  12  for  each 
particular  patch,  going  around 
rotation.  Alternate  Card  lvpos 

1  Special  end -oi -dal  a 

2  Special  end-of-data 


d  a  t  a 

)JO  ! 

i  n  t  <1 1 

i  n  i  n  >; 

a 

t  h  e 

P  a  t  c  h  i  n 

a  c  l  o  c. 

k  w  i  s  i 

1  1 

a  n  d 

12  for 

e  a  c  h 

p  ate! 

code 

=  . 

-  S)  *■>  *•>  ’•) 

code 

=  - 

-■■)  ij  9  *i 

DATA  MANAGEMENT/FACGRD 


AliiiKN’jl'!!  I.- 1  3  :  HSr.R  !  :.S'i  r.l'OfliiXS  FoK  PROGRAM  G  KI)S  UK 


Purpose 


1.  The  purpose  ni  GttPSUI'.  is  to  subtract  two  DMS-A  formatted 
-,i  i'1  lurl  data  files  and  create  a  new  DIIS-A  gridded  file. 


Desc r i pt ion 

2  •  Toe  corner  coordinates,  title  information,  and  grid  size  dat 
are  n-.iii  iron  l  tie  two  input  files.  If  the  [‘.rid  spacing  is  not 
tla-  same,  tie  program  stops.  Titli  data  for  tiie  output  file  is 
read  iron  the  run  control  input.  The  program  checks  to  be  sure 
that  the  maps  overlay  exactly.  If  not,  the  program  stops.  If 
so,  the  pro... ram  proceeds  to  substract  Ftl.KI  -  FII.K2  =  Output 
1  lie.  It  a  particular  g  r  i  d  cell  falls  outside’  of  the  area  of 
interest  on  either  ot  the  input  files,  l  lie  output  grid  cell  is 
set  to  the  a r e a -o 1 -n on i n t e r es t  code,  -999. 

Use 


3.  The  program  is  available  on  the  WKS  DPS-B  and  CYBFRNKT.  The 
following  is  the  deck  structure  lor  execution  under  the  DPS-R 
GONVK.RT  subsystem  (JR;*  command): 

!<)$$•* 

I  3  $  I  OK  NT  :  use  r  n  uir.  lie  r  .name 

20$ : OP f 1  ON : PORT RAN , NOMAP 

3<»$  :  FORTY  :  NFOR‘1 ,  Xl.XO,  XLST  1  f. ,  F I) S 

40$  :  1. 1  M  I  T  S  :!)  I  ,29K,  ,  10000 

$0  $  $  S  K  I.KCT  (  user  no  /  PORM/r.  R  DSl’B  ,  R  ) 

h0$  :  U  PDATh 

7  0  f  :  A  l,T  K  K  :  first  line, last  line 

—  your  replacement  canls  for  your  personal  changes  - 
30imi$  :  r.xhcirr;. 

30  10$  :  1. 1  !  I  TS  :  0  2  ,  I  7K  ,  ,  10000 
3020S  :TAPF9  :()  I  ,X  I  I),  ,  your  DON  grid  no.  I 
30  30$  :  TA’.’F  9  :  i)2  ,  X  2l» ,  ,  your  l)MS  g  r  i  d  no.  2 
30  40  S  :  T  Al’1.9  :  0  3  ,  X  I)  ,  ,  ,  ,  on  t  pu  t  file  name 
30  30$ : DATA :  I  * 

—  your  run  control  input  — 
h000$  :  K  N  0.1  0  K 

4.  OKI'SI'rt  is  executed  on  CYHhKNFT  througt'  PROC.I.V  (Ap|)endix  O)  . 


I.-  1  3-  I 


DAT  A  M  A  .3  At;  K  M  K  N  T  /  0  K !)  S  U  IS 


04/85 


5.  The  GRDSUB  run 

Card 

Number  Format 

control 

i  n  p  u  t 

(logical  unit  n  5 )  is 

Doscri pt i uo 

a  s 

follows 

1  f  r  e  e 

Data  type  l  1  a  >» 

=  j 

f  o  r  d  epths 

=  4 

for  elevations 

f  re  O 

UTM  x- 

coordinate 

o  f  u  p  pe  r  1 

e  f  t 

n»i  n 

corner  . 

r  r  o  e 

UTM  y- 

c  oo  r d i n  a  t e 

of  upper  1 

e  f  t 

:7ia  p 

corn 

e  r  . 

f  rt'o 

UT.l  x- 

coordinate 

o  f  lower  r 

i  ;h 

t  nap 

corner  . 

t  reo 

UTM  y- 

coo  r  <1  inate 

o 1  1  owe  r  r 

i h 

t  r’M5 

c  orner  • 

2-13  2 2  Aft 

12  lines  of  i  lent  i l  i cat i on 

i  n  ; 

oriMti  o  n 

i  o  r 

!)'!S  formatted  output. 

ft .  I  n  |ui  t  ft  MR  r  i  rl  ri 

i;  cl  data 

files 

are  read 

on  1  op,  i  c  a  1 

u  n  i 

r  s  'll  n  n  < 

0 2 .  Th  e  dit  t  e re n c  e 

file  b i 

•tween 

the  t  wo 

ridded  data 

S  (‘ 

t  s  is 

written  to  logical 

unit  n 3 

• 

DATA  MANAGEMENT /GRDSUB  I.-I3-2 


04/es 


>l\l  1-14:  l,  S  K  l  NS  1  :■  !k;  |  1  <>  NS  FOR  PKOGKA!  nTMAKKA 


Pur  pose 


I.  The  purpose  ol  I3T1IAKEA  is  to  calculate  t  lie  area  above  and 
between  specified  bathymetric  contour  levels  us  ini;  data  supplied 
on  a  IKIS-A  formatted  tile.  The  program  will  optionally  produce 
reaorts  based  on  sections  or  patches  of  the  area  of  interest. 

lie  s  c  r  i  p  t  i  on 


2.  The  program  reads  the  information  section  ol  both  the  input 
files  and  checks  to  make  sure  that  each  r  i  d  overlays  properly. 
It  so,  tin’  area  between  contours  is  computed.  II  data  are 
supplied  on  logical  unit  II,  the  computations  are  performed  by 
pa  t  c  ii  . 


Use 


1.  Tiie  program  is  available  on  the  WKS  UPS-8  and  CYBERNET.  The 
t  o  1  1  o  w  i  ni>  is  the  deck  structure  t  n  r  execution  under  the  UPS  -  8 
COAVERT  subsystem  (JRN  command): 

I0$$N 

I  5  $  :  I  t)E  .\T  :  n  se  r  n  um  he  r  ,  n  ame 
20$ : OP  r ION: FORTRAN  ,  NOMA P 
3  0$  :  FORTY  :  NFORM  ,  N I. NO  ,  N  LST  I  N  ,  F!)S 
40$  :  LI  •!  ITS  :0  1  ,  3  I  K  ,  ,  1000!) 

50$  $S  Fl.K  CT(  ii  se  r  no  /  PCRM/  HATH  ARF  A  ,  K) 
h  0  $  :  IIP  OATS 
70$  :  At. TER  :  ’i  ,n 


—  your  replacement  cards  for  lines  m  thronp.h  n  — 


5000$  : X f  CUTE 

So  1 0$ : El  ll  TS : I  ) , 2ok , , 1 0000 
5020$  :  TAP!-. 9  :  1  0  ,  X  I  I) ,  ,  your  U1S-A 
5010$  :  S'  A  PI. :  II  ,  \  2  U,  ,  your  0MS- A 
5  0  4  0  S : OAT A  :  1  * 


>;riddfd  data  value  tape  numb 
i;ridded  patch  tape  number 


—  your  run  control  input  — 


i  000  $  : >  1.1  os 

4.  tiTIl  AK  !•  A  is  executed  on  OYiiFRSKT  by  PHO0I.V  (see  Appendix  0)  . 


5.  The  run  control  input  (logical  unit  05)  to  Dili  AREA  is  as 
i o 1  lows: 


E- 1 4- I 


DATA  MANAGEMENT  /  I1T II ARF. A 
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Card  Word 


Number 

Numbe r 

format 

Descript ion 

1 

i 

F  r  e  e 

The  numbe 

r  of  p  ci  t  c  1 1  e  b  to 

h  e 

r  o 

1  o  i  c.  a  1 

unit  11.  Set  = 

•  >  i 

f 

or  sect 

ions  aro  to  hr 

u  s  e  d 

. 

> 

V  r  e  e 

Seal e  t  a e 

tor  for  input  d 

a  t  el 

v  a 

Should 

data. 

b  e  the  s  ;t  m-  si  j; 

n  a  s 

t 

) 

i 

F  r  <>  v 

Number  of 

s  pc*  c  i  f  1  e  d  Sa  t:  h 

'  e  t  r 

i  c 

2  + 

free 

User  d  e  f  i 

n  e  (1  cun  tour  It  v 

r  l  s  . 

*  *  I 

n  pu  t  ,i  f'.i  rd 

Type  ?.  fo 

r  imc  h  e onl  nnr 

Levi* 

1 

b  • 

Tlie 

;;  r  i  d  d  e  tl  data  file  is  read  on  logical  unit  1 

".  Th 

\\  r 

i  ;!  d  i>  (1 

patch  data  file  is  read  on  logical  unit  II. 

'in  t  p 

pr 

i  n  t  e  (1 

only. 

DATA  MANAGEMENT/BTHAREA  L-14-2 


ad  from 
n  o  p  a  t  c  ti 

loos, 
ho  input 

contour 


nt  i 


add !. .li'i'M  i  -  I  > :  osi.K  i  , i  k i. (.  i  i  o ;< s  kok  pk*’u.va;-i  n.ATPVoi. 


Purpose 


I  .  i  he  put  pose  i  I  I  AY  U  V  ( 1 1 ,  is  to  compiitt’  sl*oa  1  i  n;t  volumi's  lie  t  w  e  c  n 
two  .survey  dates  within  user  defined  contour  intervals.  The 
program  will  optionally  produce  reports  based  on  sections  or 
patches  or  the  area  ot  interest. 


Descript  ion 


2 .  1  he  p  r  o  ,  r  a  m  reads  the  i  n!  or  a.it  ion  section  o  t  all  the  input 

i  i  1  e  s  and  checks  to  make  sure  t  it  a  t  e  a  c  h  >;  rid  o  v  e  r  l  a  p  s  the  other 
properly.  It  so,  t  tie  two  survey  dates  are  subtracted  and  the 
depth  change  for  each  r  i  :!  cell  is  converted  to  a  volume  ciianp.e. 
It  data  are  supplied  on  logical  unit  II;  the  computations  are 
pertorned  ay  patch.  ihc  shoal  i  n;;  volumes  are  also  compared  to 
project  deptus  (siioaliup,  above  and  scour  i  n;;  lielow). 


T .  The  dent!  data  read  from  In;.;  i  cal  un 
w  i  t  ii  tin*  data  read  on  logical  unit  12. 
should  have  the  sale  scale  1  actor.  The 
s  e  ij  u  e  n  t  i  a  I  iron  one  to  the  total  niiihii  r 


t  in  nu st  overlap  exactly 
The  two  input  depth  I i 1 e s 
patch  numbers  must  he 
o  t  pat c  h  e s  . 


Use 


U  •  The  pro;, t  am  is  a  v  a  i  1  a  b  I  e  on  t  he  WKS  DI’S-H  and  CT  l>l\  K  i.  K  T.  Tht 
tollowinj;  is  the  deck  structuri'  lor  execution  under  the  UPS-S 
lit)..  V  h  KT  sulisy  iti  .n  (.lid.  cot.matiJ): 


I  OS  s:; 

l  b  S  :  I  UK  X  T  :  u  s  e  r  n  untie  r  ,  n  a  no 

20S  :0U  i  I  0?  :  KoliTKAX  .ivOHAP 

"JOS  :  FORTY  :  :VKORM  ,  X  I.XO  ,  i.  hST  f  X  ,  K»S 


'•OS  :  1.  1 

.11  IS  :  >  1  ,  1  1  K  ,  ,  1  Oio);> 

j  0  $  $  S  K 

l.h.(’.T(  use  mil  /  pop;!  /  i' 

AT  MV  0  1. , 

K) 

M)S  :  l;  I’DAT.: 

7  0S  :  Ah 

r  K  :  -n  ,  n 

- 

-  your  replacement 

c  ;i  r  M  s 

tor  line 

s  r>  t  ’n  r  o  u  >; ! 

Ii  n  — 

>l'0|)  $  ; 

.".xkcu  n; 

TOMS: 

i  r:  i  rs  :  1  ■  ,  2 *’ K  ,  ,  1  l  mo 

r)('  20  $  ; 

T AP h‘1  :  |  o  ,  X  1  '■) ,  ,  y o ii r 

DOS- A 

r  i  d  d  e  r 

t*  .1 1  a  v.i  1  jii' 

l  api-  n 1 

t  or 

e  il  l  irr 

il  a  t  e 

SO TOS  : 

T  A  i'K  h  :  I  1  ,  X  2  D  ,  ,  v  o  u  r 

DMS  — A 

,  r  i  d  lie d 

pa  tcli  t  a  po 

n  u m  h  j*  r 

SO  ITS  : 

T  A P  K ')  :  1  2  :  X  TO  ,  ,  you  r 

DMS-A 

i;  r  i  i1  d  e  d 

(1  a  t  a  v  a  l  u  r 

tape  n 

l  o  r 

latter 

d  a  t  e 

bo  . Of  : 

DATA  :  1  * 

L- 1  5-  1 


DATA  'lAXACIh.MK.XT/  AATHVOI. 


—  your  run  control  i n  pu  t  — 
l)imn  ■>  :  r  N1)J  li  'I 


I  siTitinn  on  CVhKKNKT  is  contnil  led  li  y  HKOCI.V  ( A  p  pun  ri  i  x  «)). 


.  K  u  n 

c  o  n 

t  r  o  1 

i  n 

put  (lo 

1  i  c  a  1  unit  ' '  rj  ) 

to  I,  A 

THVtM. 

i  s 

•* 

s 

t  o 

1  1 

o 

w  s  : 

Card 

W  o 

rd 

a  u  m  bo r 

's  u  r: 

her 

r  o 

r  m  a  L 

['  e  s  c  r  i 

|>  L  i  n  P 

1 

1 

K 

re  r 

T  a  e  n  un b e  r  o 1 

P  a  t  r  i« 

o  S  L  i » 

lie 

r 

.  1  c  i 

l  r 

•n 

K 0  !•’ T  R  A  ‘ .  ii  n  i 

t  ii. 

Sr  l  = 

■ '  ■; 

s 

no 

pa 

t 

C  i '  c 

sections  a  r 

e  to  S 

'*  u  S  O  li 

. 

2 

K 

r  o «' 

S  c  a  l  e  f  a  c  t  o  r 

'  or  i  it 

put  «iu 

ntl. 

V 

a  1  u 

r  s 

. 

S  Ito  u  1  d  be  s 

, '  til  c  s  i 

#  n  .i  s 

t  lie 

J 

0|'t 

r 

i{ 

1 

F 

rr 

'•umber  o  I  pro 

i  ,  cl  ' ' 

r  p  t  h  s 

P“l- 

i 

1 

i  c  a 

t  i 

o 

n  <  , 

Set  =  - i  i ! 

none 

arc  to 

111' 

u 

sol 

. 

t  + 

1 

K 

r  <  *  <_■ 

number  of  pat 

c  bos  t 

o  use 

t  h  i 

S 

P  r  o 

)  f 

i* 

t 

depth.  Tlu: 

count  i 

n  c  o  r 

pat 

c 

h 

rd 

ho 

i  n  s 

with  pate  h 

n  un  be  r 

1  a  n  d 

i  s 

r 

Ill’ll! 

1  a 

t 

i  vc 

2 

y 

r  oc 

1“  r  o  j  e  c  t  d  e  p  t  !  i 

s  pe  c  i 

f  io.it  i 

o  a  . 

Input  a  curd  typo  three  lor  unci'  .1  i  l  f  e to  <’  f  project 
do  p  tli  ** 


'.  +  1  true  'lumber  of  specified  hr  t  !n"T  trie  contour 

2  +■  free  User  d  o  t  i  n  •  ■  d  contour  levels. 

Innot  ;■  *  i  i' I  (I  type  2  tor  ;i  c  h  contour  level 

1 .  (..ridded  .lulu  .in1  input  f  ron  1  o  ;  ic.i  1  unit  lii  (earliest  in 
t  i  "i  e  )  111,1  I  o  ;  i  r  i  I  unit  1  ’’  (latest  in  tin.').  The  '.rid  d  e  d  paten 

li  a  t  a  (Iron  K  A  Cl.  K  i )  are  r  .•  a  u  on  I  o  ;  i  e  a  1  unit  II. 


D  A  T  A  M  A N  A G  EM  F.N'T  /  R  A I H  VO  I, 


A  iM.S-Ji  »H!;l  L  -  1  <1  :  U  S  F  K  l  N  ST  di'C  i  1  (JKS  KOk  PttOCKAM  DUMPFk2 


Purpose 


t.  Tin-  purpose  ol  program  DUMPKR2  is  to  produce  a  readable  dump 
from  data  that  are  in  binary  DMS-A  format. 


Description 


2.  The  program  prints  the  data  across  the  paper  in  rows  and 
columns.  lor  wide  dumps,  the  swaths  are  printed  sequentially  and 
can  he  reconstructed  by  taping  the  paper  swaths  side  to  side. 


Use 


!  3.  UUH1*KR2  reads  in  a  DNS-A  iormatLted  grid  on  logical  unit  10. 

The  dump,  in  the  lorn  ol  vertical  swaths  through  the  grid,  is 
written  to  the  line  printer  tile.  At  Cybernet,  DU  M P  K R2  is 
accessed  through  PROCLV  (see  Appendix  0). 

|  *Cr 


I 

i 


I 


I 


!  C$s 


I  -  I  h  -  I 


DATA  MANACF.MI.NT/ DUMP  F  H  ? 
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APPENDIX  M:  INTERFACE  PROGRAMS 

PART  I:  INTRODUCTION 


Purpose 


L.  This  appendix  describes  several  computer  programs  that 
serve  as  interfaces  between  the  major  programs  of  the  TABS-2 
numerical  modeling  system. 

2.  The  interface  programs  process  output  from  one  program 
so  that  it  is  in  a  form  and  format  suitable  for  input  to  a  second 
program . 


Origin  of  the  Programs 


3-  Programs  ENGMET,  BIN2F0R,  and  F0R2BIN  were  written  by 
personnel  of  the  WES  Hydraulics  Laboratory.  Program  JOBSTREAM 
was  written  by  Hydraulics  Laboratory  personnel  using  in  part  a 
program  named  RMA-3,  which  was  written  by  Resource  Management 
Associates.  Programs  TRANSA,  ELEVGRD,  and  GRDSUB  were  written  by 
personnel  of  the  WES  Enviromental  Laboratory. 


Ml 
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PART  II:  PROGRAM  DESIGN  AND  APPLICATION 


ENGMET 


4.  ENGMET  is  a  batch-oriented,  interface  program  which 
converts  GFGEN  and  RMA-2V  output  from  English  to  metric  units  for 
use  by  the  sediment  transport  program  STUDH.  It  will  also  change 
the  datum  plane,  alter  the  computation  time  interval,  and  alter 
the  length  of  simulation  hydrograph  in  the  RMA-2V  output  file. 

5.  Work  is  under  way  on  versions  of  RMA-2V  and  STUDII  that 
will  operate  in  either  system  of  measurement  units  at  the  user's 
choice.  These  versions  will  be  released  when  testing  is  com¬ 
plete. 

6.  User  instructions  for  ENGMET  are  given  in  Addendum  M-l. 


B I N  2  FOR 


7.  BIN2F0R  reads  binary  output  files  from  GFGEN,  RMA-2V, 
RMA-4,  or  STUDH  and  rewrites  them  in  formatted  form.  It  was 
originally  written  to  transfer  model  output  files  from  Boeing 
Computer  Services  to  CYBERNET  but  has  been  retained  because  of 
its  usefulness.  Program  F0R2BIN  reverses  the  process. 

8.  Output  files  from  the  major  programs  are  written  in 
binary  form  that  is  unique  to  the  vector  processing  computer.  As 
a  result,  those  files  can  be  read  only  by  the  computer  that  wrote 
them.  This  isolates  the  output  files  and  prohibits  accessing 
them  from  the  front  end  computer  unless  a  program  like  BIN2F0R  is 
used  . 


9.  Running  BIN2F0R  creates  a  formatted  data  file  containing 
the  output  results  from  GFGEN,  RMA-2V,  RMA-4,  or  STUDH.  That 
file  may  then  be  read  by  a  front-end  computer  program,  written  to 
a  tape  for  transfer,  or  accessed  and  modified  by  an  editor  pro¬ 
gram.  At  present,  the  TABS -2  system  does  not  emphasize  use  of 
these  formatted  files,  but  we  can  envision  development  of  several 
applications  that  may  be  added  later  to  the  system. 

10.  User  instructions  for  BIN2F0R  are  given  in  Addendum  M-2. 

FOR2  B I N 


11.  F  0  R  2  B I N  reverses  the  process  of  B I N  2  F  0  R ,  reading  for¬ 

matted  files  created  by  B I N  2  F  O  R  and  writing  binary  output  files 
on  the  vector  processing  computer.  It  was  developed  tor  transfer 
of  files  to  CYBERNET.  The  only  obvious  application  of  the  pro¬ 
gram  would  be  to  replace  GFGEN  output  files  that  had  been  trans¬ 
formed  by  B1N2FOR  and  then  edited.  In  most  cases,  it  will  be 
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better  to  rerun  GFGEN.  Other  uses  of  the  program  may  be  devel¬ 
oped  . 


12.  User  Instructions  for  F0R2BIN  are  give  in  Addendum  M-3. 


JOBSTREAM 


13.  Program  JOBSTREAM  creates  input  boundary  condition 
files  for  RMA-2V,  RMA-4,  and  STUDH  models  using  output  files  from 
previous  runs  of  those  programs  on  a  larger  mesh.  It  is  used  for 
running  inset  computational  meshes  that  overlap  or  lie  within 
other  meshes. 

14.  The  JOBSTREAM  approach  of  running  successively  finer 
yet  smaller  meshes  is  widely  used  in  finite  difference  modeling. 
It  permits  detailed  resolution  of  an  area  of  high  interest  with¬ 
out  the  computational  burden  of  high  resolution  over  the  entire 
area  being  modeled.  It  is  not  widely  used  in  finite  element 
modeling  since  resolution  can  go  from  very  fine  to  very  coarse  in 
the  same  mesh.  The  need  for  such  an  approach  does  arise  occa¬ 
sionally  and  is  therefore  included  as  part  of  the  TABS-2  system. 

15.  User  instructions  for  JOBSTREAM  are  given  in  Addendum 

M-4. 


Other  Interfaces 


16.  Other  interface  programs  that  are  described  elsewhere 
in  this  manual  include  ELEVGRD,  GRDSUB ,  TRANSA,  F02UN,  and  UN2F0. 


17.  Program  GRDSUB  (Appendix  L)  is  a  spatial  data  analysis 
program  used  in  the  WES  Data  Management  System  A.  It  subtracts 
one  set  of  gridded  data  from  another  and  writes  the  differences 
to  a  file  for  analysis. 

18.  ELEVGRD  converts  data  that  are  scattered  in  nonuniform 
x  and  y  locations  to  a  set  of  DM S- f o r m a t t ed ,  gridded  data 
points.  It  is  described  in  Appendix  L. 

19.  Program  TRANSA  converts  regularly  gridded  data  to  DMS-A 
formatted  gridded  data  points.  It  is  described  in  Appendix  L. 
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ADDENDUM  M- 1 :  USKR  INSTRUCTIONS  FOR  PROCRAM  KNCMET 


Purpose 


1.  The  purpose  of  this  program  is  to  convert  RMA-2V  and 
GFGKN  output  from  English  to  metric  units.  It  also  allows 
adjustments  to  the  elevation  datum  and  will  interpolate  between 
time -steps  or  extrapolate  additional  time-steps. 


Origin  of  Program 


2.  This  program  was  written  by  Messrs.  Donald  P.  Bach  and 
Stephen  A.  Adamec,  Jr.,  Estuaries  Division,  Hydraulics  Laborato¬ 
ry,  Waterways  Experiment  Station.  The  program  has  been  modified 
by  several  members  of  the  staff. 


Description 


8.  The  program  reads  bed  elevations  from  a  CFGEN  file  and 
allows  for  changes  by  card  input.  Coordinates  and  elevations  are 
converted  to  metric  units.  Next,  the  number  of  time-steps  to  be 
input  and  desired  to  be  output  is  read  from  cards,  and  the  RMA-2V 
file  is  read.  The  velocities  and  water-surface  elevations  are 
converted  to  metric  units,  and  a  water-surface  elevation  file  and 
a  velocity  file  are  written.  If  extrapolation  or  interpolation 
are  desired,  these  operations  are  performed  and  new  output  files 
written.  If  requested,  a  check  of  the  output  files  is  performed 
by  copying  a  few  nodal  point  values  for  each  time -  step  to  the 
line  printer. 


Use 


Input 


4.  Three  input  files  are  required:  (a)  a  card  image  input 

data  file  for  run  control,  (b)  a  binary  output  file  from  GKGEN 
(logical  unit  01)  which  contains  the  finite  element  network,  and 
(c)  a  binary  output  file  from  KMA-2V  that  contains  flow  veloci¬ 
ties  and  water-surface  elevations  (logical  unit  02).  These  are 
all  in  English  units. 

Output 

Three  metric  output  tiles  are  produced  by  KNGMKT:  (a) 

the  finite  element  network  tile  (logical  unit  0  t ) ,  ( b )  the  water- 

surface  elevation  tile  (logical  unit  04),  and  ( c )  the  velocity 
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file  (logical  unit  07).  All  three  of  these  are  binary  and  in 
metric  units.  In  addition  to  these,  an  optional  printout  can  be 
requested . 

6.  Optional  output  prints  the  water  surface  and  x-  and  y- 
velocity  components  at  every  node  and  for  every  time -step. 

Beware  of  the  size  of  the  printout  when  using  this  option.  Con¬ 
sider  it  only  for  debugging. 

Card  Image  Input  Data 

7.  A  description  of  the  card  image  input  for  1CNGMKT  is 
shown  in  Table  M  —  l  —  I  .  Note  tit  at  the  nonstandard  format  is  the 
only  option  for  KNGMKT  data  at  this  time. 


I  N  1  K  R  K  A  i :  K  S 


Table  M-l-1 


Card 


Card 


Card 


Card  Image  Input  Data  for  ENCMET 


1.  Format  (I5.2F5.0) 


Column 

Variable 

Value 

Description 

5 

NOM 

+ 

Number  of  node-depth  pairs  to  be 
input  from  cards  as  update  to  the 
ge  one  try  file 

10 

DATUMC 

Datum  correction  (ft) 

Water  depths  read  in  for  nodes 
card  1A  are  subtracted  form 
to  obtain  the  bed  elevation 
these  modes 

on 

DATUMC 

a  t 

1A.  Format  8(15, F5.0)  (Required  only  if  NOM  >  1) 


5 

NODE 

+ 

Node  number 

10 

DEP 

+ 

Depth  (ft) 

1  5 

NODE 

+ 

Node  number 

20 

DEP 

+ 

Depth  (ft) 

Con  t i nue 

for  NOM 

pairs 

of  data 

Format 

(515) 

5 

ITM 

+ 

Number  of  input  time-steps 

from  RMA-2V  to  convert 

10 

l  TOM 

0 

Not  used 

l  5 

IFO 

0 

No  output  check  is  printed 

1 

Output  check  is  printed 

20 

ITIOM 

>1 

Factor  used  in  interpolation 

(ITIOM  =  2  will  double  the 
number  of  time-steps) 

<1 

No  interpolation 

25 

NSKIP 

+ 

Number  of  input  time-steps  to 

skip  in  RMA-2V  output  file 
before  beginning  metric  con¬ 
version  (used  to  eliminate  spin- 
up  time) 


M-  1  -3 
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Addendum  M-2:  8  ROC  RAM  BIN 2  FOR 

Pur  pose 


1.  The  purpose  of  BIN2F0R  is  to  convert  binary  data  files 
generated  by  either  GFGEN,  RMA-2V,  RMA-4,  or  STUDH  to  coded 
files. 

Origin  of  Program 

2.  This  program  was  written  by  Mrs.  Barbara  Pa r k - Donne  1 1 , 
Estuaries  Division,  Hydraulics  Laboratory,  Waterways  Experiment 
Station. 


Description 


3  .  Alpha  records  are  written  in  a  20A4  format.  DMS  1REC 
and  FREC  information  (see  Appendix  N)  is  written  in  12  and  F2.1 
formats.  Floating  point  data  are  converted  to  an  E14.8  format 
and  integer  data  to  an  18  format.  The  program  is  run  in  a  batch 
mode  . 


Use 


4.  The  binary  final  results  file  from  either  GFCEN,  RMA-2V 
RMA-4,  or  STUDH  is  input  on  logical  unit  10,  with  the  corre¬ 
sponding  coded  file  output  on  logical  unit  20.  I  See  ITYPF.l] 

5.  The  binary  HOTSTART  file  from  either  RMA-2V,  RMA-4,  or 

STUDH  is  input  on  logical  unit  11  with  the  corresponding  coded 
file  output  on  logical  unit  21.  | See  1TYPE2] 

6.  A  second  binary  HOTSTART  file  from  STUDH  is  input  on 
logical  unit  12  with  the  corresponding  text  file  output  on  logi¬ 
cal  unit  22.  I  See  I  TYPE  3  J 

7.  Card  image  input  data  for  run  control  are  on  logical 
unit  05. 

8.  The  program  may  be  run  from  PROCLV.  See  Appendix  0  for 
command  instructions. 


Card  Image  Data  Input  Instruction 


r<m. 


9.  Only  one  line  ot  input  run  control  information  is  re¬ 
quired.  That  input  is  describe  d  in  Table  M  —  2  -  1  ,  "Description  of 

Card  Image  Input  Data  for  Run  Control.”  Valid  requests  lor 
conversions  are  shown  in  Table  M-2-2,  'Valid  Conversion  Options. 


M  -  2  -  I 


1 NTERFACES 


Table  M-2-1 


Card  Image  Input  Data  for  Run  Control 


Field  Variable  Value*  _ Description _ 

1  ICODE  GFGEN  Processing  CFGKN  files 

RMA2  Processing  RMA-2V  files 

R  M  A  4  Processing  R  M  A  -  4  files 
STUDH  Processing  STUDH  files 

2  ITYPE1  FINAL  Processing  a  final  results  file  from  the 

given  value  of  ICODE 

CONDLBED  Processing  STUDH  concentration  delbed 
(valid  only  if  I  C()I)E  =  ST  II DH ) 

_  Leave  blank  if  only  processing  a  HOT ST ART 

(valid  only  if  IC0DE=RMA-2) 

3  1TYPE2  H0TRMA2  Processing  a  HOTSTART  file  from  RMA-2V 

(if  IC0DE  =  RMA-2  ) 

H0TRMA4  Processing  a  HOTSTART  file  from  RMA-4 
(if  ICODE  =  RMA-4  ) 

HOTBEDST  Processing  a  Bed  Structure  HOTSTART  from 
STUDH  (if  ICODE =STUDH  and  ITYPE 1 =FINAL 
or  CONDLBED) 

HOTBEDEL  Processing  a  Bed  Elevation  HOTSTART  from 
STUDH  (if  ICODE=STUDH ,  and  ITYPE1=FINAL 
or  CONDLBED) 

_  Not  HOTSTART  processing 

4  ITYPE3  HOTBEDEL  Processing  a  Bed  Elevation  HOTSTART  from 

STUDH  (if  I  CODE  =  STUDH ,  and  ITYPE2- 
HOTBEDST) 

_  Not  processing  2  STUDH  HOTSTARTS 


*  Fields  are  eight  columns  wide  and  data  should  be  left- 
justified.  Table  M-2-2  shows  valid  options  for  fields  1-4. 
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Table  M-2-2 

Valid  Conversion  Options 


FIELD  1 

FIELD  2 

FIELD  3 

GFGEN 

FINAL 

RMA2 

FINAL 

RMA2 

FINAL 

HOTRMA2 

RMA2 

HOTRMA2 

RMA4 

FINAL 

RMA4 

FINAL 

HOTRMA4 

STUDH 

FINAL 

STUDH 

FINAL 

HOTBEDST 

STUDH 

F  I  NAI. 

HOTBEDEL 

STUDH 

FINAL 

HOTBEDST 

STUDH 

CONDLBED 

STUDH 

CONDLBED 

HOTBEDST 

STUDH 

CONDLBED 

HOTBEDEL 

STUDH 

CONDLBED 

HOTBEDST 

FIELD  4 


HOTBKDEL 


HOTBED  E L 


M  -  2  -  3 
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ADDENDUM  M-3:  Proi;  ram  FOR2BIN 


Pur  pose 


1.  To  convert  coded  data  files  generated  by  BIN  2  K OR  to 
binary  files  of  the  form  produced  by  GFGF.N,  K  M  A  -  2  V  ,  RMA-4,  or 
STUDH. 


Origin  of  Program 

2.  This  program  was  written  by  Mrs.  Barbara  Park-Bonnel 1 , 
Estuaries  Division,  Waterways  Experiment  Station. 


Use 


3.  The  output  tile  from  BIN  2  FOR,  for  either  GFGKN,  RMA-2V, 
RMA-4,  or  STUDH,  is  input  on  logical  unit  10,  and  the  binary 
output  file  from  F0R2BIN  will  be  written  on  logical  unit  20. 

I  See  ITYPF 1  | 

4.  The  HOTSTART  file  from  either  RMA-2V,  RMA-4,  or  STUDH 
generated  by  BIN2F0R  is  input  on  logical  unit  11,  with  the  corre¬ 
sponding  binary  file  output  on  logical  unit  21.  [See  1TYPE2] 

5.  A  second  HOTSTART  file  from  BIN2F0R  of  STUDH  is  input  on 
logical  unit  12,  with  the  corresponding  binary  file  output  on 
logical  unit  22.  |See  l  T  Y  P  K 3  | 

6.  Card  image  data  for  run  control  are  on  logical  unit  05. 

7.  The  program  may  be  run  from  PROCLV.  See  Appendix  0  for 
command  instructions. 

Card  Image  Data  Input  Instructions 

8 .  Only  one  line  of  input  run  control  information  is  re¬ 
quired.  That  input  is  described  in  Table  M -  3  -  1  ,  "Description  of 
Card  Image  Input  Data  for  Run  Control."  Valid  conversion  options 
are  shown  in  Table  M -  3  -  2 . 


M  -  i-l 


1  V  7  F  R  F  A  C  K  S 


Table  M-3-1 


Card  Image  Input  Data  for  Run  Control 


Field*  Variable  Value*  _ De  scription _ 

1  ICOn  K  G  F  G  F  N  Processing  G  F  G  K  N  files 

RMA2  Processing  RMA-2V  files 

RMA4  Processing  RM A- 4  files 

STU  Dll  Processing  STUDH  files 

2  ITYPE1  FINAL  Processing  a  final  results  file  from  the 

given  value  of  I  C  0  f)  F 

CONDLBF,  D  Processing  STUDH  concentration  del-bed 
(valid  only  if  X  CODK  =  STU  Dll  ) 

_  Leave  blank,  if  only  processing  a  HOTSTART 

(valid  only  if  IC0DE=RMA2) 

3  1TYPF.2  H0TRMA2  Processing  a  HOTSTART  file  from  RMA-2V 

(if  IC0DE=RMA-2) 

H0TRMA4  Processing  a  HOTSTART  file  from  RMA4 
(if  IC0DE=RMA4 ) 

HOT  BFI)  ST  Processing  a  bed  structure  HOTSTART  from 
STUDH  (if  I  C  0  D  F  =  S  T  U  D  H  and  r TYPE  I =F INAL 
or  CONDLBFD) 

HOTBFDFL  Processing  a  bed  elevation  HOTSTART  from 

STUDH  (if  IC0DE  =  STU1)H  and  I T  Y  P  E  1  =  F  I  N  A  L  or 
CONDLBFD) 

_  Not  HOTSTART  processing 

4  ITYPF3  HOTBFDFL  Processing  a  bed  elevation  HOTSTART  from 

STUDH  (if  1  CODE  =  ST  U  DH ,  and  IT Y PE  2 =HOT BE DST ) 
_  Not  processing  2  STUDH  HOTSTARTS 


*  Fields  are  eight  columns  wide  and  data  should  be  left- 
justified  in  each  field.  Table  M-l-l  should  be  valid  options 
for  fields  1-4. 
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Table  M- 3-2 

Valid  Conversion  Options 


FIELD  1 

FIELD  2 

FIELD  3 

CFGEN 

FINAL 

RMA2 

FINAL 

RMA2 

FINAL 

HOTRMA2 

RMA2 

HOTRMA2 

RMA4 

FINAL 

RMA4 

FINAL 

HOT  RMA4 

STUDH 

FINAL 

STUDH 

FINAL 

HOTBEDST 

STUDH 

FINAL 

HOTBEDEL 

STUDH 

FINAL 

HOTBEDST 

STUDH 

CONDL8ED 

STUDH 

CONDLBED 

HOTBEDST 

STUDH 

CONDLBED 

HOTBEDEL 

STUDH 

CONDLBED 

HOTBEDST 

M  -  3  -  3 


FIELD  4 


HOTBEDEL 
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ADUKKDUM  M-4: 


PR 'HIRAM  JiihSTRKAM  ,  VMtMOK  i.<> 


i1  u  r  p  o  s  <• 


1.  The  purpose  of  .)(  BSTKKA.M  is  t  e  create  a  set  ot  boundary 
conditions  for  an  inset  m e  s  ti  using  TASS-,’  m o  A  e  i  i  n g  system  results 
fro*  another  n  e  s  h . 


he s c r 1 |  L ion 

2.  JOBSTRKAM  is  a  batch-oriented  "rogram,  composed  of  algo¬ 
rithms  from  programs  written  by  the  Waterways  Experiment  Station 
Hydraulics  Laboratory  and  Resource  Management  Associates, 
Lafayette,  Cal i lorn i a. 

3.  The  finite  element  method  allows  variable  mesh  size 
across  the  modeled  area,  hut  there  are  still  tines  when  the 
modeler  needs  a  computational  mesh  that  fits  inside  a  large  one 
or  overlaps  it.  Operating  in  a  JOBSTRKAM  mode  permits  the 
modeler  to  run  the  larger  mesh,  thei  use  those  results  as  bounda¬ 
ry  conditions  for  a  second  mesh. 

4.  In  this  description  of  the  program,  the  term  inset  mesh 
is  used  to  denote  that  mesh  that  gets  the  boundary  conditions  and 
r  tins  second.  The  mesh  running  iirst  an  J  supplying  boundary 
conditions  is  called  the  coarse  mesh.  The  terminology  was  chosen 
to  reflect  a  standard  jobs  treats  app  oach,  but  the  inset  mesh  may 
actually  be  coarser  than  and  lie  outside  the  coarse  mesh. 


5.  Use  ot  the  jobs  treats  appro  tch  requires  some  care  by  the 
modeler.  If  the  inset  mesh  boundaries  are  too  close  to  the 
problem  area,  the  inset  mesh  solution  ray  be  inconsistent  with 
the  coarse  mesh  solution.  Some  experimentation  may  he  required 
to  locate  proper  boundaries  ior  the  inset  mesh. 

6.  The  program  reads  output  res. ills  from  the  coarse  mesh  to 
calculate  boundary  conditions  tor  the  inset  mesh,  using  shape 
functions  where  needed.  The  program  will  prepare  boundary  condi¬ 
tion  files  for  RMA-2V  hydrodynamic  model  runs  or  STL’DH  sedimenta¬ 
tion  model  runs.  A  future  version  or  :  h  e  program  will  do  so  for 
RMA-4  dispersive  transport  model  runs. 

7  .  Inset  mesh  nodes  m  a  y  h  e  c  o  incident  wit  h  n  o  d  e  s  in  t  h  c 
coarse  mesh  or  fall  within  coarse  elements.  Numbering  of 

the  two  meshes  need  not  he  related  t  -  tneb  o t  he*". 


8.  Inset  mesh  nodes  may  be  coincident  with  coarse  mesh 
nodes  or  they  may  lie  within  an  element  of  the  coarse  mesh.  If 
the  two  nodes  are  coincident,  the  program  reads  data  (velocity 
and  water-surface  elevations,  or  concentration)  at  the  coarse 
mesh  node  and  specifies  that  data  for  the  inset  mesh  node.  If 
the  inset  mesh  node  does  not  occupy  the  same  location  as  a  coarse 
mesh  node,  shape  functions  are  used  to  calculate  a  value  at  the 
inset  node,  using  results  from  the  coarse  mesh  element  in  which 
it  lies. 


9.  Program  JOBSTRF.AM  is  part  of  the  TABS-2  2-D  modeling 
system.  It  uses  the  standard  TABS-2  input  data  structure. 

10.  Input  consists  of  control  data,  described  here,  which  is 
in  card  image  and  may  be  either  on  cards  or  a  disk  file  identi¬ 
fied  as  logical  unit  5;  mesh  geometry  files  for  both  the  inset 

and  coarse  meshes;  and  a  model  results  file  for  the  coarse  mesh. 
Output  consists  of  echo  prints  of  input  data,  optional  printed 
output  of  the  calculated  boundary  conditions,  and  an  output  file 
containing  boundary  conditions  in  the  format  required  by  the 
mode  1 s  . 

11.  The  object  code  may  be  executed  using  PROCLV.  If 

P  ROC  L V  is  used,  the  input/output  logical  units  noted  as  "usual" 
on  the  $L  card  are  required. 


Card  Image  Data  Input  Instructions 


12.  Table  M-4-1  shows  the  data  card  sequence  used  as  card 
image  run  control.  Input  is  in  the  modified  HKC-6  standard.  The 
user  may  choose  between  free-field  input  and  10-8  column  fields. 

13.  The  following  pages  describe  the  card  image  input  data 
for  run  control  in  detail.  Table  M-4-2  illustrates  a  typical  job 
input  file.  Prepare  the  card  image  input  data  file  before 
executing  the  program. 
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Table  M-4-! 

JOBSTREAM  Version  1.0  Data  Card  Sequence 


Card 

Content 

Requi red 

T 1 

Title 

Yes 

$F 

Format  control 

No 

$M 

Model  designation 

Yes 

$L 

Input/output  files 

No 

TZ 

Time  controls 

Yes 

CN 

Node  correspondence  list 

Yes 

$ F  Card 


Format  Control 


Opt i ona  1 


Field  Variable  Value 


Col  1 


Description 


Col  2 


If  the  $F  Card  is  present,  the  program  expects  all  input  (except  Card  $M) 
to  be  formatted  according  to  either  (2A1,  F6.0,  9F8.0)  or  (2A1,  16,  918). 
It  it  is  not  present,  free-field  format  is  expected. 


M-4-5 
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$M  CARD 

Mode l  Ty  pe 

Field 

Variable 

Value 

Description 

Co  1  1 

ICG 

$ 

IDT 

M 

1 

MOD 

R2 

For  model  RMA-2V 

S3 

For  model  STUDH 

R4 

For  model  RMA-4  (not  available 

2 

VER 

+ 

Mode  1  version 

For  formatted  reads,  the  format  is  (2A1,  4X,  A2 ,  4X,  A4) 
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$L  Card 


Input/output  Logical  Unit  Numbers 


Optional 


Field  Variable  Value* 


Description 


Col  1 
Co  1  2 
l 


2 

3 

4 

5 

6 


ICG 

$ 

IDT 

1. 

IN 

+ 

Unit  for 

control  data.  T1  through  $M 

cards 

are  read  on  logical  unit  5 

0 

Default 

=  5 

LP 

+ 

Unit  for 

printed  output 

0 

Default 

=  6 

1NG 

+ 

Unit  for 

coarse  mesh  geometry  file 

0 

Default 

=  14 

INGI 

+ 

Unit  for 

inset  mesh  geometry  file 

0 

Default 

=  15 

INK 

+ 

Unit  for 

coarse  mesh  model  results 

0 

Default 

=  22 

IFIL 

+ 

Unit  for 

output  boundary  conditions 

0 

Default 

=  30 

*  P  ROCLV  uses  default  values  for  logical  units. 
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TZ  Card 


Time  Controls 


Required 


Field 

Variable 

Value 

Description 

Col  1 

ICG 

T 

Col  2 

IDT 

Z 

1 

'T  ^  ep 

+ 

Starting  time  for  boundary  condition 
file 

2 

TINC 

+ 

Time  increments  between  boundary 

conditions  in  same  units  as  result 
file 

3 

TDAT 

+ 

Starting  date 

4 

NSTPS 

+ 

0 

No.  of  time-steps  to  be  placed  in 
boundary  condition  file 

Will  be  calculated  from  TEND 

5 

TEND 

+ 

0 

Ending  time  for  boundary  condition 
file 

Will  be  calculated  from  NSTRS 

6 

I  OUT 

1 

0 

Print  boundary  conditions 

Do  not  print  boundary  conditions 

INTERFACES/ JOBSTREAM  M-4-8 
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GN  Card 


Boundary  Node  List 


Required 


Field  Variable  Value 


Description 


Col  1 

ICG 

G 

Col  2 

IDT 

N 

1 

NODI 

+ 

Node  number  in  inset  mesh  boundary  for 
which  boundary  conditions  are  to  be 
calculated 

2 

NODE 

+ 

0 

Node  number  in  coarse  mesh  that  has 
exactly  same  location  as  NODI 

Program  expects  a  value  for  N  E  L  E 

3 

NKLF. 

+ 

0 

Element  number  in  coarse  mesh  within 
which  NODI  falls 

Program  expects  a  value  for  NODI 

4 

NFIX 

+ 

Type  of  boundary  specification  for 
RMA-2  V 

See  RMA-2V  documentation  for  allow¬ 
able  codes  of  NFIX 


Code  one  set  of  nodes  per  card 
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Table  M-4-2 

Card  linage  Run  Control  Data  File  Example 


T1  D'rNAHl  C  BC  FILE  FOR  HESH  4  DERIVED  UIA  JOBSTREAM  FROM  MESH  1  BOOK  CFS 

*M  R2 


♦  L 

5 

6  10 

20 

30  40 

TZ 

0. 

.5 

0 

0  0  1 

GN 

191 

191 

65 

00200 

GN 

205 

205 

65 

00200 

GN 

230 

230 

65 

00200 

GN 

231 

231 

65 

00200 

GN 

23  2 

23  2 

C5 

00200 

GN 

245 

245 

77 

00200 

GN 

269 

269 

77 

00200 

GN 

270 

270 

77 

00200 

GN 

271 

271 

77 

00200 

GN 

285 

285 

88 

00200 

GN 

308 

308 

88 

00200 

GN 

309 

309 

89 

00200 

GN 

310 

310 

89 

00200 

GN 

325 

325 

101 

00200 

GN 

335 

335 

94 

00200 

GN 

336 

336 

95 

00200 

GN 

337 

337 

95 

00200 

GN 

338 

338 

96 

00200 

GN 

339 

339 

96 

00200 

GN 

340 

340 

97 

00200 

GN 

341 

341 

97 

00200 

GN 

342 

342 

98 

00200 

GN 

343 

343 

98 

00200 

GN 

344 

344 

99 

00200 

GN 

345 

345 

99 

00200 

GN 

34b 

346 

100 

00200 

GN 

347 

347 

100 

00200 

GN 

348 

348 

101 

00200 

GN 

349 

349 

101 

00200 

GN 

1039 

1039 

294 

00200 

GN 

1042 

1042 

294 

00200 

GN 

1043 

1043 

294 

00200 

GN 

1044 

1044 

294 

00200 

GN 

1048 

1048 

296 

00200 

GN 

1050 

1050 

296 

00200 

GN 

1051 

1051 

296 

00200 

C*J 

1052 

1052 

296 

00200 

GN 

1054 

1054 

297 

00200 

GN 

1055 

1055 

297 

00200 

GN 

1057 

1057 

298 

00200 

GN 

1058 

1058 

298 

00200 

GN 

1059 

1059 

298 

00200 

GN 

1060 

1060 

298 

00200 

GN 

329 

329 

217 

00200 

GN 

330 

330 

92 

00200 

GN 

331 

331 

92 

00200 

GN 

332 

332 

93 

00200 

GN 

333 

333 

93 

00200 

GN 

334 

334 

9 

00200 

(*< 

747 

747 

217 

00200 

GN 

1029 

1029 

144 

11000 

GN 

1030 

1030 

144 

11000 

GN 

1031 

1031 

144 

11000 

GN 

1033 

1033 

145 

11000 

GN 

850 

10  32 

145 

1100  o 

I  1  :  R  •  V  |-  ‘  /.in  it |  [.;  ;  \\\ 
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PART  I:  INTRODUCTION 


1.  This  appendix  describes  the  flies  used  within  the  TABS-2 
system  and  the  files  aanageaent  system. 

2.  Standard  file  foraats  are  used  to  laprove  portability  of 
the  files,  reduce  prograaalng  effort,  and  increase  readability  of 
the  flies.  The  files  aanageaent  system  was  created  to  help  keep 
track  of  where  data  are  stored.  Computer  files  are  the  standard 
input  mediua  for  TABS-2.  Many  files  are  formatted  as  card 
images,  but  in  general,  actual  cards  are  not  used. 

3.  Four  types  of  file  formats  are  used:  card-image  run 

control.  Data  Management  System  A  (DMS-A)  input,  DMS-A  output, 
and  model  output.  Program  run  control  files,  which  serve  as 
input  to  the  programs  and  specify  what  the  run  is  to  accomplish, 
are  usually  ASCII  and  appear  as  card  Images  with  lines  80  charac¬ 
ters  long.  Some  run  control  files  use  the  HEC  form  of  input  with 
an  alphanumeric  identifier  at  the  beginning  of  each  line.  Even¬ 
tually,  all  run  control  will  be  in  this  format.  Run  control 
files  are  created  and  modified  by  use  of  a  time-sharing  editor. 
Data  Management  System  A  files  and  model  output  files  are  de¬ 
scribed  in  PARTS  II  and  III  of  this  appendix. 

4.  PART  IV  of  this  appendix  describes  the  TABS-2  File 
Management  Systea.  Part  V  describes  an  optional  file  naming 
convention  that  has  been  adopted  by  the  WES  Hydraulics  Laboratory 
Estuaries  Division  and  is  recommended  to  the  user. 
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PART  II:  DMS-A  FILES 


5.  The  WES  Data  Management  System  A  (DMS-A)  is  designed  to 
store,  retrieve,  and  provide  common  analyses  of  data  that  are 
distributed  in  space.  It  works  with  both  gridded  (i.e.,  on  a 
uniform  spacing)  and  nongridded  data.  The  DMS-A  is  described  in 
Appendix  L. 

6.  Some  DMS-A  data  are  stored  as  integers,  thus  data  must 
be  multiplied  by  an  appropriate  power  of  10  to  obtain  the  desired 
degree  of  precision  if  decimal  fractions  occur  in  the  data. 


7.  Most  DMS-A  data  files  are  stored  in  binary  form.  Map 
information  is  stored  at  the  beginning  of  each  data  file  in 
several  sets  of  records,  each  record  in  216  form.  Table  N1  lists 
the  form  for  digitizer  data  input  files  for  program  ELEVGRD. 
Output  from  the  various  programs  may  use  a  standard  format  or  an 
alternate,  specialized  format.  See  Apendix  L  for  details  of  the 
various  formats.  The  DMS-A  binary  file  format  is  shown  below: 


Record 

Word 

Variable 

Type 

Description 

1 

1 

LENDAT 

INTEGER 

Code  for  type  of  data 
=  3  for  depths 
=  4  for  elevations 

2 

NXUL 

INTEGER 

X-coordinate  of  upper  left 
corner  of  grid 

3 

NYUl 

INTEGER 

Y-coordinate  of  upper  left 
corner  of  grid 

4 

NXLR 

INTEGER 

X-coordlnate  of  lower  right 
corner  of  grid 

5 

NYI.R 

INTEGER 

Y-coordinate  of  lower  right 
corner  of  grid 

2-7 

1 

NAME 

CHARACTER* 1 32 

Title  information  for  file 

8 

1 

DAT  ASC 

REAL 

Scale  factor  for  gridded  data 

2 

NX  RE 

INTEGER 

Number  of  grid  cells  in  the 
X-d irect  ion 

3 

NYRE 

INTEGER 

Number  of  grid  cells  in  the 
Y-direction 

4 

DX 

REAL 

Grid  spacing  in  X-direction 

5 

DY 

REAL 

Grid  spacing  in  Y-direction 

9  to 
NXRE-t-B 

1  t  o 
NYRE 

N 

INTEGER 

Gridded  data  values.  The 

first  value  corresponds  to 

the  upper  left  corner  of 
the  grid.  Area  of  non¬ 


interest  values  are  -999. 
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PART  III:  MODEL.  OUTPUT  FILES 


8.  Files  produced  as  output  by  the  models  have  a  common 
format  for  the  identifying  block  of  information  at  the  beginning 
of  each  file  (header  records)  but  vary  in  the  form  that  actual 
model  results  are  stored.  Storing  all  output  in  the  same  form 
would  be  convenient  but  would  greatly  increase  storage  costs 
since  many  blank  records  would  be  stored.  Files  written  by 
GFGEN ,  RMA-2V,  STUDH,  RMA-4 ,  and  ENGMET  write  output  files  as 
described  below. 

Header  Records 


9.  Header  records  are  common  to  all  of  the  output  files. 
They  contain  both  numeric  and  character  information  used  to 
describe  file  contents.  Table  N2  shows  the  header  records  struc¬ 
ture  and  their  contents.  Record  2  is  compiled  by  PROCLV.  Most 
of  the  programs  will  print  out  all  header  records  from  the  files 
that  they  read.  Figure  Nl  shows  a  typical  set  of  headers  printed 
in  the  STUDH  output. 


■  IMEI  HEtOlKS  OK  IHPUT  MOTER  SURFOCE  HE*. 

MS  MVO  OKS  RER  ION  1.0  08TE0  OCT  81.  IMIS  Fill  IS  E  RiIP  »N»  l- »El  01 1  IT 
VERSIDH  =  l.  10  08110  JUNE,  1181.  HEIIIMS  8NC  D»  I  1  HUE  Nl-Ml  I  U8I  SU8  FILE 
OHS  =  1  008 UE  =  1  PE  8 SON  =  C0PEL80D  0ESC8IPIIDM  = 

K  C81  I  888  1 1  ON 

E=H 

UESME  OHS  OEKSIOH  1.00.  08TE0  Ot I  1881.  THIS  FILE  IS  F80H  oFGEN  *t«S 

I OH  J.10  08IE0  H80  1088. 

OHS  =  LOCK  OHO  08H  1  SRODE  -  8  PE 8S0M  =  l INCH  OF  SCRIPT  ION  = 

COCK  8M0  08H  1  RED  RIRER 
CORRECTED  ECER8TIOHS 


Figure  Nl.  Example  header  records 


GFGEN  Files 

10.  After  the  two  b  ee  a  d  c  r  records,  program  GFGEN  output 
files  list  the  computational  network  description.  Record  T  is 
written  (binary  write)  as  shown  below. 

Record  3 

NP,NE((CORD(J  ,K)  ,K=I  ,2)  ,ALPHA(J) ,WD(J)  ,J=1  ,NP) 

( ( NOP (  I  ,L)  ,L=1  ,8)  ,  1  MAT (  1 )  , TH (  1 ) ,  I EM(  I  )  ,  1  =  1  .  NE  ) 


N  3 


FILES 


where 


NP  =  number  of  nodes 
NE  =  number  of  elements 
CORD(J,K)  =  x-  and  y-coordlnates  of  node  J 
ALPHA(J)  =  slope  of  element  side  at  node  J 
WD(J)  =  bed  elevation  at  node  J 
NOP(t,L)  »  list  of  6  or  8  nodes  surrounding  element  1 
IMAT(I)  =  element  type  of  element  I 

TH(I)  =  angle  for  eddy  viscosity  tensor  in  element  I 
I  EM  =  element  reordering  sequence 

RMA-2V  Files 

11.  Every  RMA-2V  run  writes  one  results  file.  If 
requested,  it  will  also  write  a  HOTSTART  file.  The  first  two 
records  in  both  files  are  the  standard  header  records. 

Results 

The  third  and  fourth  records  of  the  results  file  are  of  the  form 

3.  (TITLE!  I)  ,1=1  .20) 

4.  T,NP,((VKL(J,K) ,J=1 ,3) ,K=i ,  NP ) ,  ( NOR Y( K ) , K- 1 , NP ) ) NE , 

( IMAT(L)  ,  L=  1  ,  NE  ) 

where 

T  -  t ime 

NP  *  number  of  nodes 

V E L (  1  , K )  =  x-direction  velocity  at  node  k,  time  T 

V  E  L ( 2 , K )  ”  y-direction  velocity  at  node  k,  time  T 

VEL(3,K)  3  water-surface  elevation  at  node  k,  time  T 

NDRY(K)  =  flags  for  wet  and  dry  nodes 
IMAT(L)  =  flags  for  active  and  inactive  elements 

Set  4  is  repeated  for  each  time-step  that  the  program  executes. 

HOTSTART 

12.  The  third  record  set  of  the  HOTSTART  file  is  of  the 

form 


T  ,NP  ,NE  .NITSV , ( ( VEL( J ,K)  , J-l  , 3)  ,K= 1  ,NP) 

( VDOT( J  ,K)  ,  J=1  ,  3)  ,K-1  ,NP)  ,( VOLD( J  ,K) , J  =  l , 3) ,K«1  ,NP) 
(VDOTO(J.K)  ,J=l  ,3)  , K= 1  , N  P )  ,  ( NDRY(  I)  ,1  =  1  ,NP) 


K- . 

im 

r  - 

i*' . 

v-  ■ 


f 


f  1 1.  !■:  s 


N  4 


04/85 


whe  t  e 

T  =  tine 

NP  =  number  of  nodes 

NE  =  number  of  elements 

NITSV  =  iteration  number 

VEL(J,K)  =  x-  and  y-velocities  and  va t e r- s u r f ace  elevation  at 
node  K,  tine  T 

VD0T(J,K)  =  derivatives  of  velocities  and  water-surface  eleva¬ 
tion  at  node  K,  tine  T 

V0L0(J,H)  =  derivatives  fvelocitiesandwat.er-surface 

elevation,  time  T  -  T  (old  tine-step) 

VD0T0(J,K)  =*  derivatives  of  velocities  and  water-surface 
elevation,  tine  T  -  T  (old  tine-step) 

NDRY(I)  »  flags  for  wet  and  dry  nodes 

The  HOTSTART  file  contains  only  one  tine-step  which  is  the  final 
set  of  resul ts . 

STUDH 


13.  The  sediment  model  STUDH  produces  three  output  files — a 
concentration  and  bed  elevation  change  file,  a  (clay)  bed  struc¬ 
ture  HOTSTART  file,  and  a  final  bed  elevation  file.  Each  output 
file  contains  the  two  standard  header  records  and  each  is  written 
in  binary  torn. 

Concentration  and  bed  elevation  change 

14.  The  concentration  and  bed  elevation  change  file  con¬ 
tains  results  from  every  time -step.  It  contains  computed  sedi¬ 
ment  concentrations  and  the  cumulative  bed  change  from  the  begin¬ 
ning  of  the  run.  Record  set  5  is  repeated  for  each  tine-step. 

Record  3 

NTT  S ,( T1TLE( 1 ) , 1  =  1  , 1 8) , I YR , 1M0, IDA, I  HR  ,  IMN, ISC 

where 

NTTS  =*  number  of  time-steps 
TITLE(I)  =  alphanumeric  title  from  T3  card 
IYR  =  year 
I  MO  =  mon  t  h 
IDA  =  day 
1  HR  =  hour 


N'j 


FILES 


IMN  «  minute 


ISC  -  second 

Record  4 

NP,NE,( (CORD(  I , J) ,J-1 ,2) ,1-1 ,NP) ,((NOP(I, J)  ,J-I  ,8)  , 
I-1,NE),(AT(I),I-1,NE)  ,  ( E  LE V ( I )  ,1-1  ,NP)  ,(CONC(I)  ,1-1  ,NP) 

whe  r  e 

NP  -  number  of  nodes 
NE  -  number  of  elements 
CORD(I,J)  -  x- ,  y-coordinate  of  node  number  I 
NOP(I,J)  -  element  connection  table  for  element  I 
AT(I)  -  element  angle  for  element  1 
ELEV(I)  -  elevation  for  node  I 
CONC(I)  -  concentration  for  node  I 
Record  5 


T.(CONC(I) ,1-1  ,NP)  .(DELBED(I) ,1-  ,NP) 

where 


T  -  time 

CONC(I)  -  sediment  concentration  at  node  1 
DELBED(I)  -  bed  change  at  node  l 
NP  -  number  of  nodes 

Bed  structure 


15.  Record  3  of  the  bed  structure  file  (clay  and  mixed  beds 
only)  is  of  the  form 


T  F  ,  ( NLAY ( I )  ,1-1  ,NP) ,((RHOB( I  ,  J )  ,THICKL( I , J) 

AGE ( I,J),ITYPE(I,J),SST(I,J),J-1 , NLAY ( I) )  ,1-1  ,NP) 


whe  re 

TF  -  final  successful  time-step 
NLAY(I)  -  number  of  bed  layers  at  node  1 
RHOB(I,J)  -  bed  dry  density  of  layer  J,  node  1 
THICKL(l.J)  -  thickness  of  layer  J,  node  I 
AGE ( I , J )  -  age  of  layer  J,  node  I 

FILES  N6 


ITYPE(I.J)  =  type  number  of  layer  J,  node  I 
SST(1,J)  =  shear  strer.^th  of  layer  J,  node  I 
N  P  =  nuobe:  of  nodes 

Pinal  bed  elevation 

16.  The  final  bed  elevation  results  file  contains  the 
coapufed  bed  elevation  at  the  final  time-step  of  the  run.  Record 
3  is  the  number  of  nodes  in  the  mesh.  Record  4  is  of  the  form 


(TITLE..  1  )  ,  1  =  1  ,  i  6  .  TIMEX  ,  (  ELEV<  I  )  ,  1  =  1  ,NP) 


TITLE  =  title  from  the  input  T3  card 
TIMEX  =  time  of  final  time-step 
ELEV(I)  =  bed  elevation  at  node  I 
NP  =  number  of  nodes 


XMA-s 


17.  RMA-4  writes  a  final  results  file  and  a  hotstart  file. 
Records  1  and  2  of  each  file  are  standard  header  records. 

Results 

lb.  Re  core  3  of  the  KM*--  results  file  is  of  the  form: 


T  ,  S  0  V  A  1.  .  *•  p  ,  (  ,  -,<U  ,u-:  ,  N  ?  )  ,  X*  t  ,  NQUAL)  , 

(  LLf  .1  )  ,  J  -  i  ,  No  I  )  ,  J  =  1  ,  h' P  ) 

«he  r  e 


NQUAL  -  number  of  constituents  being  modeled 
N  P  =  number  of  nodes 

TOLD  =  concentrations  jr  time  T,  constituent  number  K, 


U  L  *  r  —  c  o  n  t  o  '  i  ■  n  t  .  .’lor.;  y  at  time  T  ,  node  J 
VI,  *  v-f  oa;  o  > ■  I  '  ..  f  ,  c  1  a  r  '  ■  y  .  ’  i  ;ie  T  ,  node  J 


19.  This  record  l  . 


• e  r  t  a  c  n  time-step. 
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HOTSTART 

20.  The  HOTSTART  information  file  contains  the  following 
data  in  Record  3  for  the  last  time-step  only. 

WRITE( IS8) NSTEP ,T0LD( NP  ,6) ,TD0T(NP,6) ,WTEMP(NP) 


where 


NSTEP  ®  time-step  number 

TOLD  =  concentrations  at  time  NSTEP,  up  to  maximum 
dimension  of  TOLD 

TOOT  -  derivative  of  concentrations  at  time  NSTEP,  up  to 
maximum  dimensions  of  TDOT 

WTEMP  -  water  temperature  at  time  NSTEP,  up  to  maximum 
dimensions  of  WTEMP 


F  II.  ES 
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PART  IV:  FILE  MANAGEMENT  SYSTEM 


21.  The  UESDMS  File  Management  System  (FMS)  is  designed  to 
be  an  automated  notebook  that  keeps  track  of  data  files  in  the 
TABS-2  system.  Early  numerical  modelers  used  black,  three-ring 
notebooks  to  keep  notes  about  each  run,  the  files  that  it 
created,  and  magnetic  tapes  containing  backup  or  archived  copies 
of  files.  The  success  of  the  black  notebook  system  always 
depends  on  the  dedication  of  the  modeler  to  keep  the  notebook 
up-to-date.  On  large  studies  that  generate  many  files  and 
employ  more  than  one  modeler,  a  more  rigorous  and  automatic 
approach  is  needed. 

22.  TABS-2  file  management  is  an  optional  approach  that 
includes  index  files,  a  maintenance  program  embedded  in  the 
procedure  files,  and  a  file  naming  convention.  A  file-naming 
convention  is  described  in  PART  V.  The  file  indices  are  kept  in 
files  that  the  FMS  program  can  search  to  locate  a  given  data  set. 
The  index  files  are  updated  automatically  by  the  procedure  for 
PROCLV . 


PROCLV 


23.  The  FMS  program  in  the  procedure  file  must  be  specifi¬ 
cally  activated  in  order  to  maintain  the  file  indices.  If  it  is 
activated,  each  f i l e - pr oduc i ng  run  causes  an  entry  to  be  made  in 
the  FMS  indices.  A  20-character  catalog  code  requested  in  the 
PROCLV  prompt  sequence  must  be  answered  properly  or  the  index 
update  program  will  abort. 


File  Codes 


2 A.  The  FMS  is  based  on  a  20-character  catalog  code  that 
identifies  the  source  and  nature  of  each  file.  It  grew  out  of  a 
file-naming  convention  adopted  for  some  projects  in  the  WES 
Hydraulics  Laboratory.  The  20  characters  are  composed  of  10 
concatenated  variables  as  shown  in  Figure  N2. 


FMS  Maintenance 


25.  The  FMS  maintenance  program  is  used  to  add  new  files  to 
the  index,  to  search  for  a  specific  file,  back  up  a  file,  or 
remove  (purge)  a  file  from  the  system.  It  can  be  run  in  interac¬ 
tive  or  batch  mode.  Addendum  N-l  provides  user  instructions. 
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FILES 


FMS  Indices 


26.  Table  N3  shows  the  master  index  for  the  11  sort 
variables  for  the  two  categories  of  Data  and  Code.  This  index  is 
composed  of  a  set  of  "FI RST , / LAST"  pointers  for  each  sort 
variable.  Tables  N4  and  N5  define  the  index  file  structure  for 
the  two  categories  of  Code  and  Data,  respectively.  The  "first" 
pointer  directs  the  search  to  the  location  of  the  "FROM/NKXT' 
pointer.  Continuing  in  this  manner,  a  quick  forward  or  backward 
search  of  a  sort  variable  is  possible.  For  a  search  of  any  given 
20-character  catalog  name,  the  above  technique  is  used  to  compose 
the  pointer  numbers  of  the  sort  variables  involved.  The 
intersection  of  these  lists  provides  all  entries  meeting  the 
given  specifications. 
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NIO 


$ 
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a.  SOURCE  (1  CHARACTER) 


F 

= 

FIELD 

DATA 

P 

= 

PHYSICAL  MODEL 

l 

= 

GFGEN 

INPUT 

G 

* 

GFGEN 

OUTPUT 

2 

= 

RMA-2V 

INPUT 

R 

= 

RMA-2V 

OUTPUT 

3 

STUDH 

INPUT 

S 

= 

STUDH 

OUTPUT 

H 

= 

HEC6  OUTPUT 

K 

= 

SOCHMJ 

OUTPUT 

P 

s= 

CODE  - 

PLOT 

A 

=* 

CODE  - 

ANALYSIS 

M 

= 

CODE  - 

MODELING 

D 

=* 

CODE  - 

DATA  HANDLING 

T 

= 

CODE  - 

MAINTAIN 

PLAN 

(2 

CHARACTERS) 

Any  2  characters 


c.  STORAGE  MEDIA  (1  CHARACTER) 


T 

= 

TAPE 

-  SITE 

1 

TAPE 

D 

= 

DISC 

-  SITE 

1 

FRONT  END 

F 

DISC 

-  SITE 

) 

BACK END 

M 

= 

MASS 

-  SITE 

I 

MASS  STORAGE 

1 

= 

TAPE 

-  SITE 

2 

TAPE 

2 

= 

DISC 

-  SITE 

2 

FRONT  END 

3 

- 

DISC 

-  SITE 

2 

BACKEND 

4 

MASS 

-  SITE 

2 

MASS  STORAGE 

C 

= 

CARD 

I  MAGE 

d.  STUDY  NO  (1  CHARACTER) 
Any  character 


e.  TEST  CONDITION  (6  CHARACTERS) 
Any  6  characters 


Figure  N  2 .  F  M  S  catalog  codes 


K  I  1 


N  I  1 


f.  FORMAT  (1  CHARACTER) 


F  *  FORMAT 

V  »  BINARY  VECTOR  MACHINE 

C  -  BINARY  FRONT  END 

S  =  SOURCE  CARD 

L  «  UPDATE  LIBRARY,  VECTOR  MACHINE 

U  =  UPDATE  LIBRARY,  FRONT  END 

D  =  UPDATE  DIRECTIVE 

g.  DATA  CATEGORY  (1  CHARACTER) 

H  =*  HYDRAULIC 
S  =  SEDIMENT 
W  =  WAVE 

Q  =  WATER  QUALITY 
B  =  BATHYMETRY 
G  =  GEOMETRY 
D  =  DMS  FILES 

h.  GRADE  (1  CHARACTER) 

A  =  EXCELLENT 
B  =  GOOD 
C  =■  FAIR 
D  =  POOR 

F  -  SEE  LIBRARIAN 


i.  DATA  SUBCATEGORY  (2  CHARACTERS) 


SE 

= 

SURFACE  ELEVEVATION 

QX 

=* 

DISCHARGE 

VX 

s 

VELOCITY 

TX 

= 

TEMPERATURE 

PX 

It 

PRESSURE 

RX 

= 

RAINFALL 

HD 

3 

WAVE  HE1GHT-PER-DIR 

SD 

= 

SPECTRAL  DISTRIBUTION 

HR 

= 

HARMONIC  RESIDUAL 

FX 

= 

FILTERED  RESIDUAL 

SS 

= 

SUSPENDED  SEDIMENT 

BM 

3 

BED  MATERIAL 

SX 

- 

SALINTY 

j.  VERSION  (1  CHARACTER) 

L  -  LIBRARY  VERSION 
R  -  RESEARCH  VERSION 

1  -  FIRST  VERSION 

2  »  SECOND  VERSION 

3  -  THIRD  VERSION 

Figure  N2.  (concluded) 


N  1  2 
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PART  V:  F  t  LF. -NAS  !.Nu  CONVENTIONS 

24.  A  standard  way  to  name  files  is  a  useful  instrument  in 
the  modeler’s  toolbox.  T!:a  T  ASS -  2  system  uses  a  reasonably 
consistent  file-naming  convention  for  program  files  and  although 
a  standard  convention  is  not  required  for  data  tiles,  it  is 
strongly  recommended.  In  this  manual  and  in  the  procedure  file, 
PROCLV,  generic  file  names  are  used. 


Program  rile  Names 


25.  In  general,  program  tiles  are  named  with  a  prefix  that 
is  an  acronym  for  the  program  name  and  version  (e.g.,  STUDH 
version  3.3  has  the  prefix  S33),  a  middle  portion  that  indicates 
the  structure  of  the  file  (e.g.,  CS  means  a  card  image  source 
file),  and  a  suffix  that  indicates  program  status  or  owner  (e.g., 
LV  means  library  version,  JS  might  indicate  Jaqueline 
Sibernetic's  personal  version).  The  complete  name  would  be 
S33CSLV  or  perhaps  333CSJS.  Note  that  the  procedure  file  names 
used  to  run  these  programs  are  not  the  same  as  the  file  names. 


Data  File  Name  s 


26.  If  only  one 
or  accessing  the  data 
possesses  total  recall 
aortals  with  fallible 
naming  convention  tor 
is  our  life  line  to  s  a 


person  is 
files  on 
,  t  r.  i  s 
n  i  •  m  >  r  i  e  s 
:  1 1  a  til  e 
fit 


going  to  be  running  the  programs 
a  tiro  jeer  and  that  one  person 
■  c  t  i  i  n  is  i! ..  t  applicable.  For 
a  a  d  shared  srojt  •'  t  s  ,  a  standard 
s  i.  a  i  r  i  than  a  convenience,  it 


2  7.  A  file-naming  convention  should  follow  the  3  - S  rule  — 
be  simple,  slavishly  followed,  and.  written  down.  Beyond  those 
requirements,  it  can  be  almost  anything.  Table  N6  shows  a 
convention  that  the  WHS  Estuaries  Division  adopted  several  years 
ago.  It  is  based  on  the  coding  shown  in  Figure  N  2 . 


r  e  n trie  F i  1 e  n  a  m  e  s 


2  8.  In  the  programs  document  tr  i  >:>.  and  P^'OCt.V  on-line  helps, 
input  and  output  tiles  are  idc-.t  it  i  e  d  tv  gene:  ic  tile  names. 

These  generic  file  names  art  code  i  n  w  iv  that  partially  iden¬ 
tifies  them.  The  ger.e  r  i  •  ‘me-  are  1  s  t  e  d  in  Table  N7. 

29.  The  generic  file  name-  are  tor  !  '.lustration  purposes. 
They  SHOULD  N 1  f  h  e  n  -  e  -1  t  ■  cam  ■  -  ‘or  a  :■  t  u  a  .  t  i  ’  ■  s  .  raining 

data. 


s  ■  t 


r  1  LFS 


0  A  /  3  5 


Table  N1 

KLEVGRD  Digitizer  Input  File  Structure 


Record 

Variable 

Set  No. 

Name 

Description 

1 

MAP 

MAP  =  map  number  (from  title 

block 

of 

maps  , 

e .g . ,  246) 

ITYPE 

User's  code  for  data  type 

2 

ICODE 

ICODE 

ICODE  -  -9 

3 

N  XU  L 

NYUL 

4 

NX  UR 

Digitizer  coordinates  of  the 

4  map 

corners 

NYU  R 

UL  *  upper  left 

UR  =  upper  right 

5 

NXLL 

LL  =  lower  left 

NYLl. 

T.R  =  lower  right 

6 

N  XI.  R 

NYI.R 

7 

MX  U  l. 

MYUL 

Map  grid  coordinates  of  the  upper  left 

and 

lower  right  map  corners  in 

1000s 

f  t 

8 

MX1.R 

MYLR 

9 

ICODE 

ICODE  =  5535; 

CODE  before  area  of  interest 

data. 

NVAL 

NVAL  =  0 

10 

NX 

NY 

* 

Coordinates  of  area  of  interest. 

1  1 

NCODE 

NCODE  =  -7777  -  before  depth 

data 

MCODE 

MCODE  =  range  number  used  for 

checking 

data 

12  ( 1-N) 

NX 

NY 

N  digitizer  coordinates  of  a 

string 

o  f 

• 

depth  readings 

1  3 

NCODE 

NCODE  =  -9999 

NCODE 

-9999 

1  4  + 

Varies  with  file  type 

F  ILLS 


N  1  4 
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Table  N2 

Standard  Header  Records  in  Model  Output  Files 


Record 

N  o  . 

Sequence 

S  o  . 

Content  s 

Form 

1 

1 

40  -  4-character 

words 

Model  identifier  (RMA-2V,  STU  DH, 
etc.)  of  last  nodel  used 

1 

2 

60  -  4-character 
wo  rd  s 

Run  control  inforaation  input 
interactively 

1 

3 

100  -  4-character 

words 

Record  1  f ron  previous  model 
output  file  that  was  used 
i  n  pu  t 

•  s 

a  s 

l 

4 

100  -  4-character 
wo  r  d  s 

Record  1  from  GFGEN  if  last 
used  was  STliDH,  otherwise 

mode  l 

null 

2 

I 

40  Integer  variables 

Run  contents  identification 

flags 

2 

2 

40  Real  variables 

Run  contents  identifiers 

3  + 

See  individual 
node  1  s 

i 


'  <9l 
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Table  N  3 

FMS  Master  Index  File  Structure 


PT 

(  1) 

SOURCE 

PT 

(  2) 

STUDY  NUMBER 

PT 

(  3) 

PLAN 

PT 

(  4) 

CONDITION 

PT 

(  5) 

STORE 

PT 

(  6) 

FORMAT 

PT 

(  7) 

CATALOG 

PT 

(  8) 

SUBCATALOG 

PT 

(  9) 

GRADE 

PT 

(10) 

ID 

PT 

(11) 

TAPENO 

PT 

(12) 

SOURCE 

PT 

(  13) 

PT 

(14) 

FORM 

PT 

(15) 

VERS 

PT 

(16) 

STORE 

PT 

(17) 

PT 

(18) 

PT 

(19) 

PT 

(20) 

PT 

(21) 

ID 

PT 

(22) 

TAPENO 

DATA  POINTERS  FIRST/LAST 


CODE  POINTERS  FIRST/LAST 


F  l  EES 


N  1  6 
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Table  N4 

KHS  Code  1 ndex  Kile  Structure 


1  . 
2. 
3  , 
4. 
3  . 
6. 

7  . 

8  . 
9  . 


SOURCE 

FORM 

VERS 

STORE 

GRADE 


POINTER  FROM/TO  NEXT  CODE  TYPE 

POINTER  FROM/TO  NEXT  CODE  OF  THAT  FORM 

POINTER  FROM/TO  NEXT  CODE  OF  THAT  VERSION 

POINTER  FROM/TO  NEXT  CODE  OF  THAT  STORAGE  MEDIA 

POINTER  FROM/TO  NEXT  CODE  OF  THAT  GRADE 


10. 

IDUSER 

POINTER  FROM/TO  NEXT  CODE  OF  THAT  USERID 

1 1 . 

TAPENO  : 

POINTER  FROM/TO  NEXT  CODE  OF  THAT  TAPE  NUMBER 

12. 

TAPENO 

SYMBOL 

FOR 

TAPE  NUMBER 

13. 

GRADE 

SYMBOL 

FOR 

GRADE 

14. 

IDUSER 

SYMBOL 

FOR 

USERID 

15. 

PASSWD 

SYMBOL 

FOR 

PASSWORD 

16. 

1  7 

SOURCE 

SYMBOL 

FOR 

SOURCE 

1  /  • 

18. 

FORM 

SYMBOL 

FOR 

FORM 

19. 

VF.RS 

SYMBOL 

FOR 

VERSION 

20. 

STORE 

SYMBOL 

FOR 

STORAGE  MEDIA 

21  . 
22. 
23. 

PERSON 

SYMBOL 

FOR 

PERSON 

24. 

25. - 

MISC 

SYMBOL 

FOR 

MISCELLANEOUS 

26. 

27.- 

-FILF.NM 

SYMBOL 

FOR 

COMPUTER  FILE  NAME 

28. 

EDNM 

SYMBOL 

FOR 

EDITION  NUMBER 

29. 

DNOW 

SYMBOL 

FOR 

DATA  CODE  WAS  ENTERED  IN  FMS 

30. 

DBACK 

SYMBOL 

OF  POTENTIAL  STORAGE  DATA 

31  . 

LIBRARY 

SYMBOL 

FOR 

LIBRARIANS  NAME  IE  VERS=L 

32. 

DESC 

SYMBOL 

FOR 

DESCRIPTION  OF  DATA  FILE 

/ 


I  1  L 
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Table  N5 


FMSDa  t  a  I ndex  File  Structure 


1 . 

SOURCE 

POINTER  FROM/TO  NEXT 

DATA 

OF 

THAT 

SOURCE 

2  . 

STUDY 

POINTER  FROM/TO  NEXT 

DATA 

OF 

THAT 

STUDY  NUMBER 

3. 

PLAN 

POINTER  FROM/TO  NEXT 

DATA 

OF 

THAT 

PLAN  NUMBER 

4  . 

COND 

POINTER  FROM/TO  NEXT 

DATA 

OF 

THAT 

CONDITION  NUMBER 

5. 

STORE 

POINTER  FROM/TO  NEXT 

DATA 

OF 

THAT 

STORAGE  MEDIA 

6. 

FORMAT 

POINTER  FROM/TO  NEXT 

DATA 

OF 

THAT 

FORMAT 

7  . 

CAT 

POINTER  FROM/TO  NEXT 

DATA 

OF 

THAT 

CATALOG 

8  . 

SUBCAT 

POINTER  FROM/TO  NEXT 

DATA 

OF 

THAT 

SUBCATALOG 

9  . 

GRADE 

POINTER  FROM/TO  NEXT 

DATA 

OF 

THAT 

GRADE 

10. 

USERID 

POINTER  FROM/TO  NEXT 

DATA 

OF 

THAT 

USERID 

1  1  . 

TAPENO 

POINTER  FROM/TO  NEXT 

DATA 

OF 

THAT 

TAPE  NUMBER 

1  2  . 

TAPENO 

SYMBOL  FOR 

TAPE  NUMBER 

1  3. 

GRADE 

SYMBOL  FOR 

GRADE 

14. 

IDUSER 

SYMBOL  FOR 

USERID 

15. 

PAS  S  WD 

SYMBOL  FOR 

PASSWORD 

16  . 

SOURCE 

SYMBOL  FOR 

SOURCE 

1  7  . 

STUDYN 

SYMBOL  FOR 

STUDY  NUMBER 

18. 

PLAN 

SYMBOL  FOR 

PLAN 

19. 

COND 

SYMBOL  FOR 

CONDITION 

NUMBER 

20. 

STORE 

SYMBOL  FOR 

STORAGE  MEDIA 

2  1  . 

FORMAT 

SYMBOL  FOR 

FORMAT 

22. 

CAT 

SYMBOL  FOR 

CATALOG 

23. 

SUBCAT 

SYMBOL  FOR 

SUBCATALOG 

24  . 

2  5  . 

MISC 

SYMBOL  FOR 

MISCELLANEOUS  FIELD 

26  .“ 
2  7.- 

-FILENM  : 

SYMBOL  FOR 

COMPUTER  FILE  NAME 

28  . 

EDNM 

SYMBOL  FOR 

EDITION  NUMBER 

29  . 

DNOW 

SYMBOL  FOR 

DATA  OF  ENTRY  INTO 

INDEX 

30. 

DBACK 

POTENTIAL  SYMBOL  FOR 

DATA 

OF 

BACKUP  STORAGE 

3  1  . 

PERSON 

SYMBOL  FOR 

PERSON  RESPONSIBLE 

FOR 

DATA  FILE 

32. 

DESC 

SYMBOL  FOR 

DESCRIPTION  OF 

DATA  FILE 

F  [  T.KS 


Table  N 7 


Index  by  (iencrlc  Input/Output  File  N  ame 


Generic 
F  i  L  e 


Name 

Purpose  of  File 

Source 

Units 

I  1  CO 

Card  image  data 

to  run  CONTOUR 

Editor 

* 

I  1  EC 

Card  image  data 

to  run  E  L  E  V  G  R  D 

Editor 

Engl  i  sh 

1  2  EC 

Digitized  input 

to  El.EVCRD 

DMSDIG 

o  r 

Editor 

English 

T  1  EM 

Card  image  data 

to  run  ENGMET 

Editor 

Engl i s  h 

12  E  M 

Update  data  for 

datum  &  MSL  for  ENOflET 

Editor 

English 

I  1G1 

Digitizer  file 

for  input  to  PR  F.  MESH 

Digitizer 

English 

1  2G  1 

Card  image  data 

to  run  PREMESH 

Editor 

English 

I3G1 

Output  from  PREMESH;  scratch 

PREMESH 

Eng  1  i6h 

I  IMP 

Local  MKT A PLOT 

lile  for  graphics 

METAB 

* 

I  l  KP 

Card  i mage  data 

tor  KKTPNT 

Editor 

Engl  ish 

1  2  KP 

Computation  g  r  t 

d  coordinator 

1 1  R  1 

Digitizer 

Eng  1  Ish 

I  3  R  P 

DMS-A  format  gfidded  data  file 

ELKVGRD 

English 

[IK! 

Card  image  d  a t  a 

for  GECKN 

Editor 

English 

I  2R  1 

Geometry  =  0 1 R 1 

trora  previous  OFGEN  run 

GFGEN 

English 

1  1  R2 

Card  image  data 

lor  R  M  A  -  2  V 

Editor 

Engl ish 

I  2R2 

Card  image  homularv  conditions  data 
tor  RMA-2V 

Editor 

o  r 

custom  program 

Engl ish 

l  'JR  2 

HOTSTART  input 

tile  f  t- »  RMA-2V 

RM A- 2  V 

English 

I  1  R4 

Card  i  mag e  d a t  a 

tor  RMA-4 

Editor 

Metric 

Units  can  be  either  Km;  I  i  s  h  or  metric,  depending  on  the  requirement  of 


Kile  T  y  p 
Coded 
C  o  d  e  d 
Cod  e  d 

Co  d  e  d 
Coded 
Code  d 
Coded 

Binary 

Coded 

Coded 

Binary 

Coded 

Binary 

Coded 

Coded 

Binary 

Coded 


the  model 
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Table  N7  (continued) 
Index  by  Generic  lnput/Ootput  File  Mane 


Cenerlc 

File 

Name 

Purpose  of  File 

Source 

Units 

File  Type 

I2R4 

BOTSTART  input  file  for  RMA-4 

RMA-4 

Metric 

Binary 

1 1  S  3 

Card  inage  data  for  STUDH 

Editor 

Metric 

Coded 

1 1  VP 

Card  image  data  for  VPLOT 

Editor 

Same  as  Coded 

data  source 

01  CO 

File  of  interpolated  values  on  uniform 
grid 

Contour 

* 

Binary 

0  1EC 

File  of  interpolated  values  on  uniform 
grid 

ELEVGRD 

* 

Binary 

0  1  EM 

Geometry  for  STUDH 

ENGMET 

Metric 

Binary 

0  2  EM ' 

Hater-surface  elevations  for  STUDH 

ENCHET 

Metric 

Binary 

0  3EM 

Velocities  for  STUDH 

ENCMET 

Metric 

Binary 

01C1 

Mid-side  nodes  from  AUTOMSH 

AUTOMSH 

Engl  1 sh 

Coded 

02C1 

Nodal  coordinates  &  connection  table  for 
corner  nodes,  boundary  flags'  A 
material  types 

RENUM 

Engl ish 

Binary 

03C1 

PLOT  file  from  QMESH  for 

METAPLOT  to  view  smoothness 

QMESH 

Engl ish 

Binary 

04C1 

Output  from  AUTOMSH  for  use  in  Input 
to  CFGEN 

POSTMSH 

Engl ish 

Coded 

01RP 

A  new  GFGEN  input  file 

RETPNT 

Eng  1 i sh 

02RP 

Scratch  file  in  TABS-2 

RETPNT 

Eng  1 l6h 

Coded 

01R1 

Geometry  data  for  RMA-codes 

CFGEN 

Eng  1 i sh 

Binary 

0  2  R 1 

New,  clean  CFGEN  card  Image  input  data  GFGEN 

(l.e.  unused  elements  &  nodes  eliminated) 

Eng  1 1 sh 

Coded 

0  1  R2 

Water  surface  and  velocity  output  file 

RMA-2V 

Eng 1 1 sh 

Binary 

*  Units 

can  be  either  English  or  metric,  depending 

on  the 

requirement  of 

the  model 

i  srn* 
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ADDENDUM  Nl:  USER  INSTRUCTIONS  FOR  FMS-HL 

This  program  may  be  run  interactively  or  in  batch  mode.  To 
make  an  interactive  run  type  the  following: 

CLEAR 

GET  ,  FMSHLLV/ PW  = - . 

FTN, I-FMSHLLV  ,L  =  OUT 
LGO. 

As  the  program  asks  questions,  answer  appropriately.  A  sample 
session  is  given  below.  The  following  pages  provide  sample  input 
for  various  FMS  operations. 

INPUT  DATA  SET  (A) 


ENTER  VALUE 

FOR 

BATCH 

IF 

BATCH 

=  0 

INSTRUCTIONS  ARE  WRITTEN 

TO  FILE  CODE  06 

(11 

BATCH 

=  1 

ONLY  ERROR  MESSAGES 

ARE  PRINTED 

ECHO 

I  F 

ECHO 

=  0 

INPUT  IS  NOT  ECHOED 

TO  FILE  CODE  06 

(11 

ECHO 

=  1 

INPUT  IS  ECHOED  TO  FILE 
CODE  06  AS  ENTERED 

IN  GENERAL, 

FOR 

BATCH 

RUNS 

ENTER 

"11" 

FOR 

INTERACTIVE 

RUNS 

ENTER 

1 

o 

o 

I 

INPUT  DATA  SET  (B) 

WELCOME  TO  THE  FILE  MANAGEMENT  SYSTEM  OF  THE  WES HL  DMS 
ALL  COMMANDS  MUST  BEGIN  IN  COLUMN  I. 

ENTER  ONE  OF  THE  FOLLOWING:  "N"  -  CREATE  A  NEW  FILE 

“A"  -  ADD  AN  EXISTING  FILE  TO  FMS 

"S”  -  SEARCH  FOR  A  FILE 

"B"  -  BACKUP  A  FILE 

“P"  -  PURGE  A  FILE 

"F."  -  EXIT  PROGRAM 

FOR  ~  N~  -  CREATE  A  NEW  FILE  AND  SET  (A)  -  00 


I  >  N 


AT  ANY  POINT  DURING  THE  QUEST  I  ON/ ANSWE R  SECTION 
YOU  MAY  TYPE  IN  A  “?”  FOR  AN  INSTRUCTION  MENU. 


ENTER  "CODE"  OR  "DATA"  AS  THE  TYPE  OF  FILES  TO  BE  CREATED. 


ENTER  "Y"  IF  YOU  NEED  PROMPTS  TO  NAME  YOUR  FILE 
ENTER  "N"  IF  YOU  CAN  ENTER  ENTIRE  FILE  NAME  INFO  SOLO. 


I>Y 


N-  1  -  1 


FILES 
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ENTER  PROJECT  CODE  (1  DIGIT) 


ENTER  SOURCE  (l  DIGIT) 


ENTER  STORAGE  MEDIA  (I  DIGIT) 


ENTER  FORMAT  (1  DIGIT) 


ENTER  USER  DEFINED  MISCELLANEOUS  (4  DIGITS) 
THERE  IS  NOT  A  MENU  FOR  THE  MISC  FIELD 


ENTER  COMPUTER  FILE  NAME 

(MAX  30  CHAR.  IF  YOUR  COMPUTER  HAS  FEWER  CHAR  FOR 
FIELD  THEN  LEFT-JUSTIFY  AND  RETURN.) 


ENTER  FILE'S  PASSWORD  (10  DIGITS).  IF  NONE  THEN  ENTER  0. 


ENTER  USERID  THAT  YOUR  FILE  WILL  BE  CATALOGED  IN 


ENTER  EDITION  NO.  (2  DIGITS)  IF  APPLICABLE  OR 


ENTER  GRADE  (1  DIGIT) 


ENTER  YOUR  LAST  NAME  (10  CHARACTERS) 


ENTER  A  BRIEF  FIi.  DESCRIPTION  (80  CHARACTERS) 
I  >TH  I S  IS  A  TEST  OF  FMS  HANDLING  A  NEW  FILE 


ENTER  VERSION 


IF  YOU  WISH  TO  DO  MORE  FMS  FUNCTINOS,  TYPE  "M" 
I  > N O  MOKE 


N-  1  -2 


«*  V-  , 


-  *  -YoV-Y  A, 


%  .  -  .  . 


FOR  BATCH  " N “ 


CREATE  A  NEW  FILE 


JOB  ,  CM 200000 ,T70 ,  P0  4  .  DONNE LL/601 
USER.CER0H8.XXXX. 

GET , FMSHLLV . 

FTN , I-FMSHLLV. 

LGO. 
h  X  T  T  ,  U  . 

DAYFILE.DAYBD. 

REPLACE , DAYBD. 

REWIND, OUTPUT. 

COPY, OUTPUT, OUT BD. 

REPLACE ,OUTBD. 

CATLIST. 

1  I 
N 

DATA 

N 

A 

AFXXXXXXXXXDVWHPTOOB 

TOOBD 

0 

CER01I8 

F 

DONNELL 

BOLOGNA  FILE  FOR  TESTING  NEW  DATA 
M 
l  1 
N 

CODE 

N 

A 

AAXXXXXXXXXDUGHRTEST 
TO  I  BD 
0 

CER0H8 

F 

DONNELL 

BOLOGNA  FILE  FOK  TESTING  NEW  CODE 
1 


634-27 30 /HYD  SEDIMENT/ 


CYBER  CONTROL  LANGUAGE 


BATCH  OPTION 
NEW 

DATA  FILE 

NO  PROMPTS 

SITE  =  ATCHAFALAYA 

CATALOG  NAME 

FILE  NAME 

NO  PASSWORD 

USER  ID 

NO  EDITION  NUMBER 
GRADE 

PERSON  RESPONSIBLE 

ENTRY  BATCH///////////////////// 

MORE  FMS  FUNCTIONS 

BATCH 

NEW 

CODE  FILE 

NO  PROMPTS 

SITE  =  ATCHAFALAYA 

CATALOG  NAME 

FILE  NAME 

NO  PASSWORD 

USERID 

NO  EDITION  NUMBER 
GRAD  E 

PERSON  RESPONSIBLE 

ENTRY  BATCH//////////////////// 

VERSION 
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FOR  "A"  -  ADD  AN  EXISTING  FILE  TO  FMS  AND  SET  (A  -  00 

ENTER  "Y"  IF  YOU  NEED  PROMPTS  TO  NAME  YOUR  FILE 

ENTER  “N"  IF  YOU  CAN  ENTER  ENTIRE  FILE  NAME  INFOR  SOLO. 

I  >  Y 

ENTER  PROJECT  CODE  (1  DIGIT) 

I>_ 

ENTER  SOURCE  (1  DIGIT) 

I>_ 

ENTER  STUDY  NUMBER  (1  DIGIT) 

I>_ 

ENTER  PLAN  NO.  (2  DIGtTS) 

I> _ 

ENTER  CONDITIONS  (6  DIGITS) 

I> _ 

ENTER  STORAGE  MEDIA  ( l  DIGIT) 

I>_ 

ENTER  FORMAT  (I  DIGIT) 

I>_ 

ENTER  DATA  CATEGORY  (1  DIGIT) 

I>_ 

ENTER  DATA  SUBCATEGORY  (2  DIGITS) 

1> _ 

ENTER  USER  DEFINED  MISCELLANEOUS  (4  DIGITS) 

THERE  IS  NOT  A  MENU  FOR  THE  MISC  FIELD 

I> _ 

ENTER  COMPUTER  FILE  NAME 

(MAX  30  CHAR.  IF  YOUR  COMPUTER  HAS  FEWER  CHAR  FOR 
FILE  THEN  LEFT-JUSTIFY  AND  RETURN.) 

I> _ _ 

ENTER  FILE'S  PASSWORD  (10  DIGITS).  IF  NONE  ENTER  0 

I> _ 

ENTER  USERID  THAT  YOUR  FILE  WILL  BE  CATALOGED  IN 
I> _ 

ENTER  EDITION  NO.  (2  DIGITS)  IF  APPLICABLE 
I> _ 

ENTER  GRADE  ( 1  DIGIT) 

I>_ 

ENTER  YOUR  LAST  NAME  (10  DIGITS) 

FILES  N-l-4 
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FOR  BATCH  "A"  -  ADD  AN  EXISTING  FILE  TO  INDEX 


BTCHBD  EDITED  AND  RE 
OLIST 

JOB , CM200000 ,T70 , P04 
USER .CER0H8 ,XXXX. 
GET,  FMSHLLV. 

FT N  ,  I  -FMSHLLV . 

LGO . 

EX  IT, U. 

DAYFILE .DAYBD. 
REPLACE , DAYBD. 

REWIND , OUTPUT . 

COPY .OUTPUT , OUT  B  D . 
REPLACE , OUT  BD . 
CATLIST. 

1  1 
A 

DATA 

N 

A 

A1XXXXXXXXXDFGXXBIGA 
AG V  I  BIG 
0 

CER0H8 


DONNELL 

ATCHAFALAYA  BIG  GRID 
M 
1  l 
A 

CODE 

N 

A 

AMXXXXXXXXXDSGXXVV22 
Rl  VCSF2 
0 

CER0H8 


DONNELL 

RMA-1V  LIBRARY  VERSIO 
L 

B  .  DONNELL 
NO  MORE 
*  WF.  O  I  . 


PLACED , 


.DONNELL/601-634-2730/HYD  SEDIMENT/ 


BATCH  OPTION 
ADD 

DATA  FILE 
NO  PROMPTS 
SITE  =  ATCHAFALAYA 
CATALOG  NAME 
FILE  NAME 
NO  PASSWORD 
USER  ID 

NO  EDITION  NUMBER 
GRADE 
PERSON 

INPUT  FOR  RMA-1V  (ABOUT  1900  NODES  -  600  ELEMENTS) 

MORE  TO  COME 
BATCH  OPTION 
ADD 

CODE  FILE 
NO  PROMPTS 
SITE  =  ATCHAFALAYA 
CATALOG  NAME 
FILE  NAME 
NO  PASSWORD 
USER  ID 

NO  EDITION  NUMBER 
GRADE 
PERSON 

N  WITH  COMDECK  AND  CHANGES  FOR  BIG  GRID  RUNS. 

LIBRARY  VERSION 
LIBRARIAN’S  NAME 
NO  MORE  FMS  FUNCTIONS 


N-  1  -6 


.tv.  -Av. 


FOR  ~S~  -  SEARCH  THE  PROJECT  INDEX 
I>S 

ENTER  "COOK"  OR  "DATA" 

I> _ 

ANSWKR  THE  FOLLOWING  WITH  THE  REQUIRED  NO.  OF  DIGITS 

OTHERWISE  ENTER  "?" 

ENTER  SITE  (1  DICIT)  -  THEN  RETURN 
SOURCE  ( 1  DIGIT) 

STUDY  NO.  (I  DIGIT) 

PLAN  (2  DIGITS) 

CONDITION  (6  DIGITS) 

STORAGE  (1  DIGIT) 

FORMAT  (1  DIGIT) 

CATEGORY  (1  DIGIT) 

SUBCATEGORY  (2  DIGITS) 

GRADE  (1  DIGIT) 

USERID  ( 10  DIGITS) 

TAPE  NO.  (10  DIGITS) 

I>_ 

I>_ 

1>_ 

I>_ 

I> 

I>_ 

l> 

I> 

I>_ 

I>_ 

I> 

I> _ 

IF  YOU'VE  MADE  A  MISTAKE  TYPE  "T" 

I  >0K 
NO.  =  8 

A  CEROH8  0  D  X  XX  XXXXXX  D  F  D  XX  PFMS 

FILE  NAME  =  AINDX  EDITION  NO.  =  -- 

CREATED  =  8  1/05/20.  STORED*  PERSON*  DONNELL  DESCRIPTION* 

FMS  POINTER  INDEX  FOR  ATCHAFALAYA  PROJECT  -  DO  NOT  ALTER!!  SEE  B.P 
DONNELL! ! 

000000  000000  000000  000000  000000  000000  000000 

000000  000000  000000 

IF  YOU  WISH  TO  DO  MORE  FMS  FUNCTIONS,  TYPE  "M" 
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FOR  BATCH  "S"  -  SEARCH  THE  INDEX 


OLD.TBCHBD 

OLIST 

JOB,CM200000,TY0,P04. 
USER.CER0H8 ,XXXX. 

GET, FMS  H  LL V / PW= - 

FT N , I  =  DM S I B D  . 

LGO. 

EXIT.U. 

DAYF  I  LE , DAYBD. 

REPLACE  ,  DAYBD . 

RF.WI  ND,  OUTPUT. 

COPY  .OUTPUT , OUT  B  D . 
REPLACE  ,  OUTB  D . 
CATLIST. 

0  1 
S 

CODE 

A 

7 

? 

?  ? 

7  ?  7  ?  ? 

D 

7 

7 

7  7 
F 

?,????7?7? 

7777?777?7 

OK  GO 
M 

0  1 
S 

DATA 

A 


?  7 

777777 

7 

7 

7 

?  7 

F 

7777?7?777 

???7?????? 

OK 

NO  MORE 
*  W  E  0  I  . 


DONNELL /601-634-2730/HYD  SEDIMENT/ 


BAT  CH  =  0  ECHO=  1 

SEARCH 

CODE  FILES 

ATCHAFALAYA  INDEX 

SOURCE 

STUDY  NO. 

PLAN 

CONDITION 
STORAGE 
FORMAT 
CATEGORY 
SUBCATEGORY 
CRADE 
USER  ID 
TAPE  NO. 

NO  MISTAKES 

MORE  FMS  FUNCTIONS 

BATCH=0  ECHO* 1 

SEARCH 

DATA  FILE 

ATCHAFALAYA  INDEX 

SOURCE 

STUDY  NO. 

PLAN 

CONDITION 
STORAGE 
FORMAT 
CATEGORY 
SUBCATEGORY 
GRADE 
USER  ID 
TAPE  NO. 

NO  MISTAKES 

NO  MORE  FMS  FUNCTIONS 


N-  1  -8 


FOR  " P "  -  PURGE  A  FILE  ON  BCS  DISK 

I>P 

ENTKR  PURGE  PERMISSION  PASSWORD 
ENTER  “CODE"  OR  "DATA" 

ENTER  CATALOG  NAME  (20  CHARACTERS) 
ENTER  GRADE  (I  DIGIT) 

ENTER  USERID  (10  CHARACTERS) 

ENTER  VERSION  (1  CHARACTER) 

I  > _ 

1> _ 

I> 

I>_ 

l> _ 

1>_ 

IF  YOU  WISH  TO  DO  MORE  PURGES  TYPE 
1>N0 


'<9, 


N  —  l  — 


t  tu‘ 
m  a  s  t 
I  i*  .'i  r 
prov 
c  a  n 

SI'SS 


(cci. 

c  o  m  p 

S.  \ 


APPhNDIX  0:  PROCl.V,  PKOCK  DU  RK  KILLS  KOR  JOB  CONTROL 


PART  I.  INTRODUCTION 


1.  PROCl.V  is  a  master  procedure  file  which  is  used  to  run 
computer  codes  associated  with  TABS— 2.  The  purpose  of  the 

or  procedure  is  to  permit  the  user  to  run  '"ABS-2  jobs  without 
nine,  details  or  job  control  language.  It  a,  .omplislies  this  by 
iding  a  prewritten  set  of  job  control  language  (JCL)  that 
be  selected  by  tltc  user  in  a  prompt-driven  interactive 
ion. 

2.  Tiie-  procedure  file  is  written  in  Cyber  Control  Language 

)  and  the  corresponding  control  language  for  the  vectorizing 
niter  on  which  the  programs  run. 

J.  PROCl.V  was  written  by  B.  Pa  r  k -Donne  l  1  ,  I).  P.  Bach,  and 

.  Art  a  nor,  Jr.,  of  the-  WKS  Hydraulics  Laboratory. 


0  I 


PROCl.V 


04/85 


PART  II.  USK  OF  P  ROC  L V 

PROCLV  Installation 


4.  PROCLV  is  installed  on  each  user's  disk  storage  area. 
Installation  is  accomplished  by  accessing  the  library  version  of 
the  fiLe,  PROCLV 2,  moving  it  to  the  user  number  where  it  is  to  be 
used,  and  customizing  it. 

5.  Once  a  customized  PROCLV  procedure  file  is  established, 
a  more  user-friendly  computer  environment  is  established.  The 
TABS- 2  modeler  is  not  required  to  learn  either  front-end  or 
vector  machine  JCL.  The  modeler's  efforts  may  be  concentrated  on 
the  project  and  not  the  pec u lari  ties  of  the  computer. 

6.  For  each  user  number  running  the  TA8S-2  system,  PK0CLV2 
is  edited,  following  the  NKWU  instructions,  as  seen  in  Figure  01, 
and  a  resulting  customized  procedure  tile,  PROCLV,  is  stored. 
Three  steps  are  required  to  customize  PROCLV  on  Cybernet.  Using 

a  terminal  in  communication  with  Cybernet  front  end  computer,  the 
user  enters  these  commands: 

GET,  PK0CLV=  PROCLV  2/  UN  =  CF.  R01I4 

BEGIN , HELP , PROCLV , NKWU 

X K  1)  IT  ,  PROCLV 


The  second  s t e p  gives  instructions  for  editing  the  tile  ns  shown 
in  F i g ure  01. 


Capabilities 


7.  The  current  contents  and  capabilities  ol  a  customized 
PROCLV  e  an  he  obtained  by  the  command: 

BEG l N , HELP  .PROCLV 

Figure  02  shows  the  messages  that  will  be  printed  by  this  com  mam 
and  ttie  categories  ot  the  modules  available.  Detailed  informa¬ 
tion  lor  each  of  the  modules  can  be  obtained  by  the  command: 

BE GIN, HELP, PROCLV, module  name 

where  module  name  is  the  name  of  the  program  or  group  of  programs 
tor  which  information  is  needed. 


(i.i 


PROCLV 


TABS  2  Programs 


8.  In  ;;oneral,  the  procedure  call  for  a  given  program  is 
the  same  as  the  program  name,  hut  there  .are  some  exceptions* 

Table  01  lists  the  TABS-2  programs  and  gives  the  procedure  name 
to  use  and  the  appendix  that  describes  the  program. 

System  Utilities 

9.  Several  system  utilities  are  available  through  PR0C1.V. 
These  utilities  perform  housekeeping  and  monitoring,  chores  that 
are  commonly  used  by  modelers.  For  example,  dl'.IJOB  creates  an 
object  version  of  a  program  and  is  used  to  create  custom  versions 
o l  the  programs.  Other  utilities  are  listed  in  Table  02. 

10.  JSTS  (Job  Status)  is  a  particularly  useful  time-sharing 
utility  program.  It  tracks  a  batch  job  as  it  moves  through 
input,  execution,  and  output.  If  the  user  requests,  JSTS  will 
attach  a  job  as  it  enters  the  output  queue,  make  the  output  a 
local  file,  and  automatically  go  into  XKDIT.  PROCLV  HKLP  gives 
instructions  tor  JSTS.  To  use  it,  type  the  following  once: 

C K  T , JSTS/HN  =  CKR0P9  <CR> 

Thereat  ter  in  the  same  time-sharing  session, JSTS  nay  be  invoked 
h  y  typing: 

JSTS,  job, instruct  <CR> 

who  re 

job  =  thi>  7  character  job  name  to  track,  or  L*  will 
automatical  1 y  t  i  n d 

1)  last  job  submitted  from  a  procedure  file, 

2  )  it  none,  last  j  o  b  s  u  b  m  i  t  t  e  d  from  present 

terminal  , o  r 

3  )  it  none,  last  job  routed. 

T*  will  automatically  I  i  n  d 

1)  last  job  submitted  from  a  terminal  or 

2)  it  none,  last  job  routed. 

instruct  =  additional  instructions  to  execute  after  job 
returns. 

I)*  means  make  the  job  a  local  file  to  the  terminal 
and  go  into  XKDIT;  then  a  <Ck>  in  XKDIT  mode 
will  automatically  list  d ay  f  i  I  e  . 

(;*  means  make  the  job  a  local  file  to  the  terminal  . 


0  3 


PROCI.V 


Generic  Kile  Names 


12.  The  HI  LP  prompts  in  PPOOl.v  use  generic  I  i  1  o  names  to 

identity  input  and  output  tiles.  These  Generic  names  have  been 
developed  to  help  the  user  understand  the  tile  contents.  The 
generic  name  concept  is  explained  in  Appendix  :  tiles  and  KdS. 

Table  03  lists  the  generic  names  and  their  I nnct  ions  . 

13.  The  user  must  not  use  the  generic  tile  names  .is  actual 
file  names  when  invokim;  PI.OCLV. 


P  ROC  L V 


0  A  /  8  5 


/BEGIN, HELP, PR0(XV2,tCWU 
NEHU 

HffORMATION  ON  SETTIN6  UP  THIS  FILE  FOR  NEW  USERS.  ALL  CHANGE  CfffWCS  ARE  IN 
XEDIT  FORMAT. 

TO  OBTAIN  Tt€  MASTER  PROCEDURE  FILE 

GET  ,PROCLU=PROCLU2/UN=C£ROH9 
BEGIN, INSTALL , PROCLV 

-  ANSWER  THE  OLE  ST  I  [NS  THE  PRX  ASKS  - 

-  HILL  CHANGE  USER  fWCERS,  PASSWORDS,  AND  PROBLEM  SIZE  - 

-  FOR  ANT  AOOITKMAL  CHANGES,  SEE  BELCH  - 

XEDIT, PROCLV 

TO  SET  UP  LIM(  INFO  ON  CYBER  205  (fCCESSMY  TO  MOX  205  FILES  TO  KOE) 

BEGIN, LINKNEW, PROCLV  <CR>  (AFTER  THIS  PROCEDURE  FILE  IS  SET  UP) 

TO  CHANGE  FROM  WES  PMNE  NUMBER  — 

C/(601)634-3111AOURPHONE/* 

WERE  YOURPHONE  =  NEW  PHONE  MICER 
EXAMPLE  -  0/(601)634-3111/(601)634-3163/* 

TO  CHANGE  ORGANIZATION  AND  LOCATION  FROM  USAEHESHE,  VICKSBURG  — 

C/USAEWESHE,  VICKSBUR6A0UR0R6,  YOURLOC/* 

WERE  Y0UR0R6  =  NEW  ORGANIZATION  NAtC 
YOURLX  =  NEW  CITY  AND  STATE 

TO  CHANGE  MAILING  INFORMATION  USED  TO  HAIL  CALCOMP  PLOTS  — 

C/HATERHAYS  EXPERIMENT  STAT I QN/YOURPLACE/ 

C/HYDRAULICS  LABORATORYAOUROFFICE/ 

C/P.O.  BOX  631AQURP0/ 

C/HALLS  FERRY  RQAOAPUR  STREET/ 

C/VICKSBURG,  MS  39180AOURTOW/ 

WHERE  YOURFLACE  =  f€W  STAT  I  IN  OR  DISTRICT 
YOUROFFICE  =  NEW  OFFICE  OR  DIVISION 
YOURPO  =  NEW  POST  OFFICE  BOX 
YOURSTREET  =  NEW  STREET  AOORESS 
YOURTOW  =  NEW  CITY,  STATE  (tf>  ZIP  CODE 

TO  SET  UP  L1W  I)FO  ON  CYBER  205  (NECESSARY  TO  MOVE  205  FILES  TO  KOE) 

BEGIN, 11MVCW, PROCLV  <CR>  (AFTER  THIS  PROCEDURE  FILE  IS  SET  UP) 

***  YOUR  FINAL  VERSION  OF  THIS  PROCEDURE  SHOULD  BE  NAMED  'PROCLV  **** 

REVCRT.  HELP 


(•'  i  j’  ii  r  c  i)|.  |‘  B  !i  (I  l  V  i  it  ■.  t  i  I  I  t  i  u  n  instructions 


t'KOCI.V 
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/BEGIN,  HELP.PR0CLV2 
HELP 

WESK  OPERATING  SYSTEM,  OCTOBER  3,  1984,  GENERAL  INFORMATION 


LISTING  OF  AMAILA8LE  CATAGORIES  .... 


I 


1)  UTILITIES  (UTIL)  -  THE  USER'S  SURVIVAL  KIT. 

2)  PREPROCESSING  (PREP)  -  COOES  HANDLING  GRID  PREPARATION 

3)  MODELS  (MODE)  -  ALL  SUPPORTED  TABS-2  FE  NUMERICAL  MODELS 

4)  POSTPROCESSING  (POST)-  CODES  EXAMINING  FE  MODEL  RESULTS 

5)  DMSA  (DMSA)  -  CODES  USED  IN  DATA  MANAGEMENT  SYSTEM  A 

6)  NENU  (NEWU)  -  INFORMATION  ON  CUSTOMIZING  THE  MASTER  PROC 


i 


FOR  HELP  ON  AVAILABLE  CATAGORIES, TYPE— - 
BEGIN ,  HELP ,  PROCLV ,  WTNAME  <CR> 

WHERE  CATANAME  =  THE  1ST  4  CHARACTERS  OF  1  OF  THE  ABOVE  CATAGORIES 


•j 

A 


WIEN  ALL  ELSE  FAILS,  CALL  WES-HE  TABS-2  HOTLINE : (601 )634-2801  OR  (X-2821) 
REVERT.  HELP 


Hi  filin'  II 2.  PILOCLY  MAIN  II K  I.  P 

/BEGIN, HELP, PROCLV, UTIL 
UTIL 

UTILITIES 

ssr=*=s== 

ASKDMS  -  ADDS  FILE  MANAGEMENT  SYSTEM  INFORMATION  TO  MODEL  JCL  FILES 

BIN2F0R  -  CONVERTS  205  BINARY  TABS-2  FILES  TO  FORMATTED 

FNONOOE  -  FINDS  A  NOOE  IN  A  rE  GRID  GIVEN  COORDINATES 

F0R2BIN  -  CONVERTS  FORMATTED  TABS-2  FILES  TO  205  BINARY  (F2BCSL3) 

GENOB  -  UPDATE  AND  COMPILE  PROGRAMS  ON  THE  CYBER  205 
*  GRANT  -  GIVES  A  NEW  USER  NUMBER  PERMISSION  TO  ALL  LIBRARY  WESHE  CODES 

X  JABT  -  ABORT  A  JOB  RUNNING  ON  BATCH  USER  NUMBER 

X  JOVT  -  DIVERT  A  J08  CHARGED  TO  BATCH  USER  NUMBER  TO  A  DIFFERENT  RJE  ID 

X  JFND  -  LISTS  ALL  J08S  CHARGED  TO  YOUR  BATCH  USER  NUM8ER 

JSTS  -  JOB  STATUS  TRACKING  SYSTEM  FOR  CYBERNET 

X  JPRI  -  CHANGE  THE  PRIORITY  OF  A  JOB  CHARGED  TO  BATCH  USER  NUMBER 

LINKNEH  -  SETS  UP  DATA  FOR  THE  CYBER  205  LINK  COFMAND  TO  USE 
MIL  -  ADOS  BAM4ERS  TO  A  FILE,  OPTIONALLY  PRINT  SHIRS  IT,  AND 
SENDS  IT  TO  AN  RBF  PRINTER 
META  -  METAPLOT  ONLINE  POSTPROCESSOR 
METAB  -  METAPLOT  CALCOMP  POSTPROCESSOR  (BATCH  JOB) 

READSBU  -  READS  CYBER  205  SBU  FILE  AND  EXTIMATES  COMPUTER  COST  TO  DATE 
TA8SMSG  -  PRINTS  ONLINE  MESSAGE  ABOUT  TABS-2  SYSTEM  STATUS 
205COM  -  SENDS  m  CCM1AND  TO  THE  CYBER  205  FOR  EXECUTION 


IHIII))IIIIIIHiil)ll>l*illll>>l>»VIIIIII>IIIIIUnil>*l>ilHlllil*IUI**t*lU<I 

9  NOTE:  *  INDICATES  THAT  PROCEDURE  IS  NOT  YET  IMPLEMENTED  ON  CYBERNET 

X  INDICATES  THAT  PROCEDURE  IS  REPLACED  BY  A  STOCK  CDC  UTILITY 

kkkkkkkkkkkkkkkkkkkkkkkkikkkkkkkkkk-kkkkk-HtkkkkkkkHkkkkkikkkkkkkm** 


FOR  HELP  ON  PARAMETERS,  TYPE- — 

BEGIN, HELP, PROCLV, PROCNAME  <CR> 

^  WHERE  PROCMLF  =  ONE  OF  THE  NAMES  LISTED  ABOVE 

jl  REVERT.  HELP 

l  imit-.’  i)3.  i’kiiclv  utii. mils  help 


P 


PROCLV 
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/BEGIN, HELP, PROaV.PREP 
PREP 

PREPROCESSING 


AUTOMSH  -  CREATES  GRIDS  BY  REGION  (RUNS  PREMESH,  9CSH,  REMIT,  AND  POSTMSH) 
EDGRG  -  EDIT  GRIDS  GRAPHICALLY  (EDGRG) 

ELEVGRD  -  iWCES  REGULAR  GRID  FROM  SCATTERED  DIGITIZER  DATA 
GFGEN  -  RUNS  TIC  TABS  BATCH  PREPROCESSOR  (GFGEN) 

JOGSTRM  -  SETS  UP  BOdCARY  CONDITIONS  FOR  INSET  GRID 
QPUJT  -  PLOTS  OUTPUT  FROM  RENUM,  WINDOWING  BY  SECTION 

RETPNT  -  PaLS  VALUES  AT  SELECTED  LOCATIONS  FROM  REGULAR  GRID 

CAN  BE  USED  TO  ADD  HATER  SURFACE  ELEUATIONS  TO  GFGEN  HffUT  FILE 


FOR  HaP  ON  AARAfCTERS,  TYPE - 

BEGIN, HELP, PROaV.PROCNflME  <CR> 

MCRE  PROCNAfC  *  ONE  OF  THE  NAMES  LISTED  ABOVE 
REVERT.  (CLP 
/BEGIN, HELP, PROCtV.HOOE 
MODE 
MODELS 


ENGffT  -  RONS  COMCECTION  BETLEEN  RMA2V  AND  STUDH  (ENGCSL3) 

RMA2V  -  RUNS  THE  TABS  2-D  FE  VaOCITY  HOOa  (RHA2V  VERSICN  23) 
RNM  -  RUNS  THE  TABS  2-D  FINITE  ELEMENT  QUALITY  MODEL  (RHA4) 
STUDH33  -  RIMS  THE  TABS  2-0  SEDIMENTATION  MODEL  (STUDH  VERSION  33) 


FOR  HELP  ON  PARAMETERS,  TYPE— - 
BE61N,Hao,PRTtV, PROCNAME  <CR> 
WERE  PROCNAME  -  ONE  OF  THE 
REVERT.  HaP 


NAMES  LISTED  ABtME 


Figure  04. 


PROCI.V  PREPROCESSING  HELP 


I 


MODE 

MODELS 


ENGMET 

-  RUNS 

RMA2V 

-  RUNS 

RMA4 

-  RUNS 

STUDH33 

-  RUNS 

COMCECTION  BETWEEN  RMA2V  AND  STUDH  ( ENGCSL3) 

THE  TABS  2-0  FE  VELOCITY  MODEL  ( REW2V  VERSION  23) 
THE  TABS  2-D  FINITE  ELEMENT  QUALITY  MODEL  (RMA4) 

THE  TABS  2-D  SEDIMENTATION  MODEL  (STUDH  VERSION  33) 


FOR  HELP  ON  PARAMETERS,  TYPE - 

BEGIN, HELP, PROCLV. PROCNAME  <CR> 

WHERE  PROCNAME  *  ONE  OF  THE  NAMES  LISTED  ABOVE 
REVERT.  HELP 
/ 


I  /'■<* 

r  ■*" 


i  i,-uru-  OS.  PROCiV  MODELS  HELP 


t’ROCI. 
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m 


/BEGIN, HELP, PROCLV, POST 
POST 

POSTPROCESSING 


CONTOUR 

POSTHYD 

PSTQUAL 

POSTSED 

SEDGRAF 

VPLOT 

H06PL0T 


CREATES  VECTOR  PLOTS  OF  SEDIMENT  TRANSPORT  FOR  1  OR  MORE 
HYDRQGRAPH  SOLUTIONS  OF  STUDH  CONC  DEL/BED  FILES,  AND 
COMPUTES  SHOALING  VOLURNS.  (ACE0BL3) 

CONTOURS  DATA  FROM  GFGEN,  RMA2,  RMA4,  AND  STUOH  (CONTOUR) 

GENERAL  PURPOSE  RM2V  POSTPROCESSOR 

GENERAL  PURPOSE  RMAA  POSTPROCESSOR 

ANALYZES  DEPOSITION/EROSION  ACTIVITY  FROM  STUOH 

PLOTS  CONCENTRAT I QN/BED-CHANGE  FROM  STUDH 

PLOTS  VELOCITY  VECTORS  FROM  RMA2V 

PLOTS  HET/DRY  PORTIONS  OF  GRID  FROM  RMA2V  RESULTS 


FOR  HELP  ON  PARAMETERS,  TYPE— 

BEGIN, HELP, PROCLV, PROGWtf  <CR> 

WHERE  PROCNAME  =  (NE  OF  THE  NAMES  LISTED  ABOVE. 
REVERT.  HELP 


Killin'  04.  I'KOCLV  I’OST  l*  HOCKS  S  I  N(,'  IlhL!’ 


/BEGIN, HELP, PROCLV, OMSA 
DMSA 

DATA  MANAGEMENT  SYSTEM  A 


*  BATHVOL 

*  BTHAREA 

*  DGPLT 

*  DMSDIG 

*  DLMPER2 
ELEVGRD 


COMPUTES  VOLUMES  BETWEEN  2  SOS  OF  GRIDDED  DATA 
CALCULATES  ARES  BETWEEN  CONTOURS 
QUALITY  CONTROL  AND  PLOT  OF  DIGITIZED  DATA 
COWERT  DIGITIZER  TABLET  OUTPUT  TO  INPUT  FOR: 

ELEVGRD, REFMT,RETPNT,PREKSH,FAC6RD,C0NPEG 

PRINTS  SWATHS  OF  GRIDDED  DATA  (DWS  OUTPUT  OF  ELEVGRD  S  TRANSA) 

CREATES  A  REG  OMS-FORMATTEO  GRID  FROM  RANDCHY  DISTRIBUTED 

(X,Y,Z)  DIGITIZED  DATA 

SETS  UP  A  PATCH  OR  FACTOR  MAP 

COFWERT  UN2F0  OUTPUT  BACK  TO  DMS  GRIDDED  BINARY 

PLOTS  30  LINE  PLOTS  FROM  ELEVGRD  FILE  WITH  4  POINTS  OF  VIEW 

WRITES  A  SET  OF  GRIDDED  DIFFERENCES  BETWEEN  2  GRIDDED  DATA  SETS 

MERGES  TABULAR  DATA  INTO  (X-Y)  GRIDOED  DATA  SETS 

MERGES  STANDARD  HYDROGRAPHIC  SURVEY  DATA  INTO  (X-Y)  GRIDDED  DATA 

MERGES  GRIDOED  DIGITIZED  DATA  FROM  SEVERAL  MAPS 

COWERTS  SPECIAL  DIGITIZER  FILES  INTO  FORMAT  REQUIRED  BY  ELEVGRD 

RETRIEVES  DATA  PTS  FROM  A  PREVIOUSLY  CREATED  DMS  FORMATTED  GRID 

TRANSFORMS  GRIDOED  DATA  FROM  1  GRID  SYSTEM  TO  ANOTHER 

CONUERT  DMS  GRIDOED  DATA  FILES  TO  FORM  PORTABLE  BETWEEN  COMPUTERS 


NOTE:  ♦  INDICATES  THAT  PROCEDI'1  £  IS  NOT  YET  IMPLEMENTED  ON  CYBERNET 


REVERT.  HELP 


I'Knri.v  DMS- A  IIKI.l’ 


-x 


v3  V—  r 


Ti*-* 
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Table  1)1 

Prop,  ram  Procedure  Name  Index 

p  rockam* 

P  U  R  P  0  S  K 

APPKND I X 

ai:k 

A  s  s  e  n  hie  S  T  U  I)  li  events,  c  o  m  p  u  t  e  b  e  d 
chan  g  e  noil  dredging  v  o  1  u  in  e  s  ,  plot 
sediment  transport  vectors. 

J 

AUTtlHSII 

Create  computational  meshes. 

1) 

HATH  V  01, 

Compute  volume  of  sediment  difference 
between  two  surveys. 

L 

K  I  a 2 FOR 

Trans  lorn)  binary  model  output  tiles  to 

1  o  rpi.i  1 1  ed  files. 

J 

HT  It  a  K  A 

Compute  areas  within  contours. 

1, 

CON K  K G 

C  o  n  v  e  r  t  d  i  g  i  t  i  z  e  r  f  i  1  e  t  o  G  F  0  F  N  f  o  r  n  a  t 

I) 

CONTOUR 

Plot  contour  map  of  specified  data. 

I 

DRUG  I!  K  PUT 
(  DKGPI.T) 

Plot  path  of  a  drogue  moving  with 
current  . 

T 

1)  MS  DIG 

Digitize  data  trom  a  map  or  graph. 

1, 

DGPI/r 

Plot  digitized  data  for  checking,. 

L 

1)  I  KF.CT 
(  M  K  T  A  ) 

Display  a  plot  on  a  graphics  terminal. 
Display  a  plot  on  a  CALGOMP  device. 

1 

I 

DUMP  hi  2 

Print  g ridded  data  in  swaths 

I, 

CDCKG 

Kdit  computational  network  interne,  tivcl  y 

.  1) 

Kl.KVGRI) 

Create  standard  DCS  data  tormat  file 
from  randomly  spaced  data. 

I. 

K  N  G  M  K  T 

T  r  a n s 1  a t  c  R M  A -  2  V  output  trom  K n g l i s  h 
units  to  SI  units  lor  use  hv  STUD  II. 

M 

FACCRI) 

Set  up  factor  or  patch  map. 

1, 

F  0  2  1 1 N 

Trans turm  lor  matt  nil  tile  to  DMS  binary 
lorn. 

1. 

*S(t  PRoCl.V  HKI.r  tor  latest  information  on  availability. 
Procedure  names  shown  in  parentheses  if  dilferent  from 
p  r  o  g  ram  name. 
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Tabic  01  (Continued) 


PROGRAM* 

PURPOSE 

F  0  R  2  )J  1  N 

Tran storm  formatted  no  d  e 1  output  tile 
to  binary  files 

s 

4  VIEW 

Plot  psuedo-3-D  graphs. 

(J  F(»  K  N 

Create  geometric  data  tile  for  use  by 
models  . 

C.RDSUR 

Subtracts  one  set  of  gridded  data  from 
another  and  writes  results  to  a  file. 

J OHSTkKAM 
( J on  ST  KM) 

Computes  boundary  conditions  for  an 
i  n se t comp u tat ionalnctwork using 
results  of  a  larger  network  model 

run. 

M  K  S  H  1 

Merges  tabular  data  into  a  gridded 
data  set 

M  K  S  It  2 

M  e  r  g  e  s  st  a  n  d  a  r  d  b  y  d  r  o  g  r  a  p  hie  stir  v  e  y 
data  into  a  gridded  data  sot. 

MKSH3 

Merges  gridded  data  from  several  maps 

• 

POSTHY!) 

Analyze  results  of  an  RMA-2V  run  and 
plot  time -histories. 

POSTSKD 

Summarize  results  of  a  STUDH  run. 

RKTPNT 

Interpolates  gridded  data  to  provide 
data  at  specified  points. 

K  K  K  M  T 

Co  n  v  e r  t  special  digitizer  data  files 
to  standard  format. 

R  M  -  2  V 
(RMA2V) 

Compute  two-dimensional  flow  and  wale 
levels. 

r 

R  M  A  -  4 
( RMA4 ) 

Compute  transport  of  dissolved  an d 
suspended  substances. 

SF.DCUA 

Produce  (actor  map  of  S  T II  P 1  i  results. 

*Sco  PROCl.V  IIKbP  for  latest  information  on  nvnilabil 
Procedure  names  shown  in  parentheses  if  different  f 
p  r  o  g  r  a  n  n  <i  mi1  . 


APPENDIX 


>  ty 
r  om 


P  ROC  h V 


T.i  hie  01  (  (Ion  t  i  11  no  il  ) 


r  KUC  i<  A  H  _ P  11  K  I*  0  Sj: _  A  P  P  K  N 1)  1  X 

S  n:  li  li  Com|iut  r  t  r.ins  |ior  t  ,  c  ros  i  <>  n  ,  a  n  d  (1 

(STl'IJH  V$)  deposition  ot  si\l  iments. 

TKA1.SA  T  r.inslorns  data  from  one  i>  r  i  d  system  to  \. 

a  no t  he  r  . 

It  .'J  2  K  li  T  r  a  n  s  t  o  r  in  b  l  n  ary  lor  in  d  a  t  a  t  o  L 

t  i  >  r  in  a  1 1  e  d  lorn. 

V  PI.  <)  T  I’  r  o  t  n  c  e  v  e  c  t  o  r  plots  o  t  KM  A  -  2  V  I 

velocity  results. 

UIHMM.T  Plot  vet  and  dry  areas  of  computational  1 

mesh  as  calculated  hy  RNA-2V. 


*Sei  P  ROCI.V  HI.  I,  P  tor  latest  information  on  availability. 
Procedure'  names  shown  in  parentheses  il  different  from 


truer  a  in  n.ine, 


System  Utility  Procedure  Index 


1'  r  o  c  e  d  u  r  e  & 

Program  Name  _ Pur  po  se 


ASKDMS 

Add  FMS 

information 

t  o 

j  e  i. 

file 

G  K  N  0  11 

Create 

l  r om 

object  code  program  file 
source  or  update  code 

J  A  ill* 

Abort  a 

job 

J  DVT* 

Divert 

a  batch  job 

t  o 

a  d  i 

f  f  e  r  e 

nt  KJF. 

d  F  Ml)* 

List  all  batch  jobs 
your  user  number 

r  u  n  n i n  g  under 

J  P  R I  * 

Change 

priority  of 

a  batch 

j  o  tl 

JSTS 

Track  a  job  through 
its  output  a  1  o  c a 

system 
1  file 

a  n  d 

when 

m  a  l<  e 
c o  m pint 

1.  I  N'KNKW 

MAI  1. 

Adds  banners  to  a  f 
to  a  printer 

i  1  e 

a  n  d 

send 

s  i  t 

21'  n  COM 

Sends  ,i 

command  to 

t  lie 

CY  b 

F  P.  .M) 

"a 

*  Has  Seen  replaced  by  a  CYbF.K  command.  PKMCIY  iH'l.P  contains 
instructions  on  command. 
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n  1  ; 
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Table  03  (continued) 
Index  by  Generic  Input/Output  File  Name 

Generic 


*•' i  If* 

Name 

Purpose  of  File 

Source 

Units 

File  Type 

l  2R4 

1I0TSTAKT  input  file  for  RMA-4 

- 

RMA-4 

Metric 

Binary 

11  S3 

Card  image  data  for  STUDII 

Ed  i  t  o  r 

Me  trie 

Coded 

i  IV  P 

Card  image  data  for  VPLOT 

Editor 

Same  as  Coded 

data  source 

(31  CO 

File  of  interpolated  values  on 
grid 

uniform 

Contour 

* 

Binary 

0  1  EG 

File  of  interpolated  values  on 
grid 

uniform 

ELK V GRP 

* 

:si  nary 

01  EM 

Geometry  for  STUI3H 

F NO MKT 

Me  trie 

Binary 

02  EM 

Water-surface  elevations  for  STUDH 

ENGMET 

Me  trie 

binary 

03EM 

Velocities  for  STUDII 

F.NCMET 

Metric 

Binary 

0  l  G  1 

Mid-side  nodes  from  AUTOMSH 

AUTOMSH 

Engl  is  \\ 

Cod  e d 

0  2  G  1 

Nodal  coordinates  6  connection 
corner  nodes,  boundary  flags 
material  typos 

table  for 
& 

RKNUN 

English 

Binary 

0  3C  1 

PLOT  file  from  QMKSH  for 

MKTAPLOT  to  view  smoothness 

QMKSII 

Eng  L  i  s  !i 

Binary 

04G  1 

Output  from  AUTOMSH  for  use  in 
to  GFGE.N 

Input 

POST  MSI! 

K  n  g  1  i  s  h 

Coded 

0  I  KP 

A  new  GFGF,  N  input  file 

RKTPNT 

K  n  g  l  i  s  h 

0  2  UP 

Scratcli  file  in  TAiiS-2 

RETPNT 

Engl  i  s!j 

Coded 

0  1  11 1 

Geometry  d.itn  tor  RMA-codes 

GFCKN 

Kn i;l  is  1i 

binary 

0  2  K  1 

New,  clean  GFCKN  card  inage  input  data  GFCKN 

( i • c •  unused  elements  6 1  nodes  eliminated) 

Kn  i;  1  i  s  h 

Code  d 

!)  1  K  2 

Water  surtace  and  velocity  output  file 

RMA-2V 

Knj;  1  i  s  h 

B  i  nary 

Units  can  b  e  either  English  or  metric,  depending  on  the  requirement  o  t  t  ti  e  model. 
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014 


E 


Tabic  03 

Index  by  Generic  Input/ Output  File  Name 

Purpose  of  File  Source  l 


File  Type 


Card  ima;;c  data 

to 

run  CONTOUR 

Editor 

* 

Coded 

Card  imaf*e  data 

■  to 

run  ELKVGRD 

Ed i tor 

English 

Code  d 

Digitized  input 

to 

ELEVCRD 

DMS  DIG 

o  r 

Editor 

Engl  i  s  h 

Coded 

Card  image  data 

t  o 

run  ENCMKT 

Editor 

English 

Coded 

Update  data  tor 

d a  turn  *■  MSL  for  ENGMKT 

Editor 

English 

Coded 

Digitizer  file 

f  or 

input  to  PREMESH 

Digitizer 

Eng  1 i sh 

Coded 

Card  image  data 

t  o 

run  PREMESH 

Editor 

Engl i s  h 

Coded 

Output  from  PKEMESH 

;  scratch 

PKEMESH 

Eng  1 i sh 

Local  MKT A PLOT 

file 

for  graphics 

METAB 

* 

Binary 

Card  imago  data 

t  or 

KETPNT 

Editor 

English 

Coded 

Computation  grid  coordinator 

HR] 

Digitizer 

ling  1  1  sh 

Coded 

IJMS-A  format  g  r  i  d  d  e  d  data  file 

El.EVGRD 

Eng  1 i sh 

Binary 

Card  image  data 

for 

CFGEN 

Editor 

Engl  i  s  h 

Coded 

Ge one  t  r  y  =  0 1 K 1 

from  previous  GFGKN  run 

GFGKN 

Eng l i s  h 

Binary 

Card  image  data 

for 

RMA-2V 

Editor 

Engl i s  h 

Coded 

Card  image  boundary 
for  KMA-7V 

conditions  data 

c 

Editor 

or 

ustom  program 

Eng l  i  sh 

Code  d 

liOISTA  T  input 

tile 

tor  R  M  A - 2  V 

RMA-2V 

Kng 1 i sh 

Binary 

Cn r  1  image  d  a  t a 

t  o  r 

RMA-4 

Ed  i  t  or 

Me  trie 

Coded 

Units  can  be  either  English  or  metric,  depending  on  the  requirement  ot  the  model. 


01  1 


PROCLV 


Ge  neric 
Kilo 
Name 


Table  03  (concluded) 
l  ndex  by  Generic  Input/Output  Kil e  N  a t 


Purpose  of  File 


HOTSTART  RMA-2V 


Quality  parameters  OUTPUT  file 


HOTSTART  RMA-4 


Bed  change  and  concentrations 


Plot  file  of  values  to  be  contoured 


Plot  file*  of  KK  mesh 


Plot  file  of  velocity  vectors 


CKGEN  or 
QPLOT 
VP  LOT 


Kile  T  y  p  e 
Binary 
Binary 
Binary 
Binary 
Binary 
Binary 
Binary 


*  Units  can  be  either  English  or  Metric,  depending  on  the  requirement  of  the  model. 
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